# init(wrappedValue:) Creates a new state object with an initial wrapped value. ``` nonisolated init(wrappedValue thunk: @autoclosure @escaping () -> ObjectType) ``` ## Parameters `thunk` An initial value for the state object. ## Discussion You typically don’t call this initializer directly. Instead, SwiftUI calls it for you when you declare a property with the `@StateObject` attribute in an [`App`](/documentation/SwiftUI/App), [`Scene`](/documentation/SwiftUI/Scene), or [`View`](/documentation/SwiftUI/View) and provide an initial value: ``` struct MyView: View { @StateObject private var model = DataModel() // ... } ``` SwiftUI creates only one instance of the state object for each container instance that you declare. In the above code, SwiftUI creates `model` only the first time it initializes a particular instance of `MyView`. On the other hand, each instance of `MyView` creates a distinct instance of the data model. For example, each of the views in the following [`VStack`](/documentation/SwiftUI/VStack) has its own model storage: ``` var body: some View { VStack { MyView() MyView() } } ``` ### Initialize using external data If the initial state of a state object depends on external data, you can call this initializer directly. However, use caution when doing this, because SwiftUI only initializes the object once during the lifetime of the view — even if you call the state object initializer more than once — which might result in unexpected behavior. For more information and an example, see [`StateObject`](/documentation/SwiftUI/StateObject). --- Copyright © 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)