diff --git a/docs/resources/data-representation/custom-data-types.md b/docs/resources/data-representation/custom-data-types.md index d0e1146f..2d5d0a68 100644 --- a/docs/resources/data-representation/custom-data-types.md +++ b/docs/resources/data-representation/custom-data-types.md @@ -68,7 +68,42 @@ When naming custom data types, always use **UpperCamelCase**, as recommended by ## Accessing Custom Data Type -After creating the custom data type, you can use it to create variables, such as an app state variable, and then access them. Here's an [example](app-state.md#app-state-variables). +After creating a custom data type, it’s treated internally as a [Dart class](https://dart.dev/language/classes). However, just defining the custom data type doesn’t hold any real data. To work with actual data, such as storing a user profile or a review, you need to create an **instance** of custom data type. + +Creating an instance allows you to: + +- Assign specific values to each field in your custom data type. +- Store the instance in app state, page state, or pass it between widgets. +- Access individual fields wherever needed. + +To create an instance of a custom data type, first you need to [create a state variable](../../ff-concepts/state-management/state-variables.md#creating-state-variables) (of type **Data Type**) that will hold the instance. Then, to create and add the instance to the state variable, open the **Set from Variable** dialog and select **Create Data Type Object > Project Data Type**. Choose the data type you want to use. After that, set values for each of the required fields. + + +