# EnvironmentObject A property wrapper type for an observable object that a parent or ancestor view supplies. ``` @MainActor @frozen @propertyWrapper @preconcurrency struct EnvironmentObject where ObjectType : ObservableObject ``` ## Overview An environment object invalidates the current view whenever the observable object that conforms to changes. If you declare a property as an environment object, be sure to set a corresponding model object on an ancestor view by calling its [`environmentObject(_:)`](/documentation/SwiftUI/View/environmentObject(_:)) modifier. > Note: If your observable object conforms to the > > protocol, use ``doc://com.apple.SwiftUI/documentation/SwiftUI/Environment`` instead of `EnvironmentObject` and set the > model object in an ancestor view by calling its ``doc://com.apple.SwiftUI/documentation/SwiftUI/View/environment(_:)`` > or ``doc://com.apple.SwiftUI/documentation/SwiftUI/View/environment(_:_:)`` modifiers. ## Topics ### Creating an environment object [`init()`](/documentation/SwiftUI/EnvironmentObject/init()) Creates an environment object. ### Getting the value [`wrappedValue`](/documentation/SwiftUI/EnvironmentObject/wrappedValue) The underlying value referenced by the environment object. [`projectedValue`](/documentation/SwiftUI/EnvironmentObject/projectedValue) A projection of the environment object that creates bindings to its properties using dynamic member lookup. [`Wrapper`](/documentation/SwiftUI/EnvironmentObject/Wrapper) A wrapper of the underlying environment object that can create bindings to its properties using dynamic member lookup. ## Relationships ### Conforms To [`Sendable`](/documentation/Swift/Sendable) [`DynamicProperty`](/documentation/SwiftUI/DynamicProperty) [`SendableMetatype`](/documentation/Swift/SendableMetatype) --- 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)