---
title: "instantiateInitialController(creator:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nsstoryboard/instantiateinitialcontroller(creator:)-529r1"
---

# instantiateInitialController(creator:)

Creates the initial window controller from the storyboard and initializes it using your custom code.

## Declaration

```swift
func instantiateInitialController<Controller>(creator: ((NSCoder) -> Controller?)? = nil) -> Controller? where Controller : NSWindowController
```

## Parameters

- `creator`: A block that contains your custom creation code for the window controller. Use this block to create the window controller, initialize it with the provided coder object and any custom information you require, and return the result. This block returns a new window controller object and takes the following parameter: If you return nil from your block, this method creates the window controller using the default doc://com.apple.appkit/documentation/AppKit/NSWindowController/init(coder:) method.

## Discussion

Discussion Every storyboard file has an initial controller object that represents the default interface to create. Use this method to construct that object using a custom code that you provide. Use this method when the constructor for your object takes parameters in addition to the specified coder object. In your creator block, create the window controller using your custom constructor method. Your custom constructor method must accept an NSCoder parameter and must call the inherited init(coder:) method at some point during its execution. Not doing so is a programmer error.

## See Also

### Loading the Initial View Controller

- [instantiateInitialController()](appkit/nsstoryboard/instantiateinitialcontroller().md)
- [instantiateInitialController(creator:)](appkit/nsstoryboard/instantiateinitialcontroller(creator:)-pi04.md)