How to create a SwiftData Model in Swift

The following tutorial has been made available, along with a simple app for demonstrating SwiftData, through the tutorial/swift-data-basics branch on our Open Source Swift Starter Project.

In the XCode project, create a new file and name it after your model.

We recommend that you place this under a SwiftData folder within the Models folder.

Import SwiftData and create a class that uses the @Model macro.

Please note that as of September 11th 2023, the model class requires an init function. We recommend that you type out the parameters for the class and then type init within the class, allowing Xcode to auto-complete the init function.

For more information about SwiftData Models and their annotations, consult the links below.

Consult our quick start guide or search our blog to find educational content on learning how to use SwiftData, Swift or XCode.

If you cannot find SwiftData, you are probably not using Xcode 15+ or do not have iOS 17+ installed on your iPhone / XCode.

Consult our Quickstart guide for links to these items.

This will appear if you have not set the projects minimum dependency to iOS17.

As of writing this article, @Model macro's require an initialization function. Within the model type init and let XCode auto-complete the initialization function.

Add a @Attribute(.unique) prefix to the variable.

For other annotations within the Model macro, consult the links below.

To include complex values such as structures, enumerations or other value types to a SwiftData model, make sure that they conform to the Codable protocol.

To tell SwiftData that a variable should not persist and always start at a default value on launch, use the @Transient annotation.

For other annotations within the Model macro, consult the links below.