<!--
{
  "availability" : [
    "iOS: 8.0.0 - 26.0.0",
    "iPadOS: 8.0.0 - 26.0.0",
    "macCatalyst: 13.1.0 - 26.0.0",
    "macOS: 10.8.0 - 26.0.0",
    "tvOS: 9.0.0 - 26.0.0",
    "visionOS: 1.0.0 - 26.0.0",
    "watchOS: 3.0.0 - 26.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "SceneKit",
  "identifier" : "/documentation/SceneKit/SCNScene/init(named:inDirectory:options:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "SceneKit"
    ],
    "preciseIdentifier" : "c:objc(cs)SCNScene(cm)sceneNamed:inDirectory:options:"
  },
  "title" : "init(named:inDirectory:options:)"
}
-->

# init(named:inDirectory:options:)

Loads a scene from a file with the specified name in a specific subdirectory of the app’s main bundle.

```
convenience init?(named name: String, inDirectory directory: String?, options: [SCNSceneSource.LoadingOption : Any]? = nil)
```

## Parameters

`name`

The name of a scene file in the app bundle.

`directory`

The path to the subdirectory of the bundle’s resources directory containing the scene file.

`options`

A dictionary of options affecting scene loading, or `nil` for default options. For available keys, see Scene Loading Options.

## Return Value

A new scene object, or `nil` if no scene could be loaded.

## Discussion

This method provides a convenient way to load a complete scene from a file in the app’s main bundle. Calling this method is equivalent to using the <doc://com.apple.documentation/documentation/Foundation/Bundle> class to locate the scene file and passing the resulting URL to the [`init(url:options:)`](/documentation/SceneKit/SCNScene/init(url:options:)-7ugvv) method.

For more detailed options or to load only part of a file’s scene graph, use the [`SCNSceneSource`](/documentation/SceneKit/SCNSceneSource) class.

When creating a scene using Xcode’s Scene Editor or an external tool, you should copy your scene file into a directory with the .scnassets extension inside your app bundle. You should also place any image files referenced as textures from that scene in an Asset Catalog. Xcode will optimize the scene and texture resources for best performance on each target device, and prepare your texture resources for delivery features such as App Thinning and On-Demand Resources.

---

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)