<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 18.0.0 -",
    "visionOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/DocumentGroupLaunchScene",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI24DocumentGroupLaunchSceneV"
  },
  "title" : "DocumentGroupLaunchScene"
}
-->

# DocumentGroupLaunchScene

A launch scene for document-based applications.

```
nonisolated struct DocumentGroupLaunchScene<Actions> where Actions : View
```

## Overview

You can use this launch scene alongside [`DocumentGroup`](/documentation/SwiftUI/DocumentGroup) scenes.
If you don’t implement a `DocumentGroup` in the app declaration, you can get
the same design by implementing a [`DocumentLaunchView`](/documentation/SwiftUI/DocumentLaunchView).

If you don’t provide the title of the scene, it displays the application
name. If you don’t provide the actions builder, the scene has the default
“Create Document” action that creates new documents. To customize the
document launch experience, you can replace the standard screen background
and title, add decorative views, and add custom actions.

A `DocumentGroupLaunchScene` configures the document browser on the bottom
sheet to open content types from all the document groups in the app
definition. A `DocumentGroupLaunchScene` also configures the document groups
to create documents of the first content type that your application can
create and write.

For more information, see `FileDocument.writableContentTypes` and
`ReferenceFileDocument.writableContentTypes`.

## Topics

### Creating a launch scene with a background view

[`init(_:_:background:)`](/documentation/SwiftUI/DocumentGroupLaunchScene/init(_:_:background:))

Creates a launch scene for document-based applications with a title, a
set of actions, and a background.

[`init(_:_:background:backgroundAccessoryView:)`](/documentation/SwiftUI/DocumentGroupLaunchScene/init(_:_:background:backgroundAccessoryView:))

Creates a launch scene for document-based applications with a title, a
set of actions, a background, and a background accessory view.

[`init(_:_:background:backgroundAccessoryView:overlayAccessoryView:)`](/documentation/SwiftUI/DocumentGroupLaunchScene/init(_:_:background:backgroundAccessoryView:overlayAccessoryView:))

Creates a launch scene for document-based applications with a title, a
set of actions, and a background.

[`init(_:_:background:overlayAccessoryView:)`](/documentation/SwiftUI/DocumentGroupLaunchScene/init(_:_:background:overlayAccessoryView:))

Creates a launch scene for document-based applications with a title, a
set of actions, a background, and an overlay accessory view.

### Creating a launch scene with a background style

[`init(_:backgroundStyle:_:)`](/documentation/SwiftUI/DocumentGroupLaunchScene/init(_:backgroundStyle:_:))

Creates a launch scene for document-based applications with a title, a
background style, and a set of actions.

[`init(_:backgroundStyle:_:backgroundAccessoryView:)`](/documentation/SwiftUI/DocumentGroupLaunchScene/init(_:backgroundStyle:_:backgroundAccessoryView:))

Creates a launch scene for document-based applications with a title, a
background style, a set of actions, and a background accessory view.

[`init(_:backgroundStyle:_:backgroundAccessoryView:overlayAccessoryView:)`](/documentation/SwiftUI/DocumentGroupLaunchScene/init(_:backgroundStyle:_:backgroundAccessoryView:overlayAccessoryView:))

Creates a launch scene for document-based applications with a title, a
background style, a set of actions, and background and overlay accessory
views.

[`init(_:backgroundStyle:_:overlayAccessoryView:)`](/documentation/SwiftUI/DocumentGroupLaunchScene/init(_:backgroundStyle:_:overlayAccessoryView:))

Creates a launch scene for document-based applications with a title, a
background style, a set of actions, and an overlay accessory view.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)