Training Create a Data Model

Training: Create a Data Model

What you'll learn: how to create a data model, the naming rules, and where fields and deployment happen. You need: Administrator or Developer access type, an Application Development application. Time: 8 minutes.

Before you start

Pick the Data Model Kind — it determines how the model behaves:

Kind	Use it for
Reference	Standalone records with their own API (most models)
Embeddable	Structures embedded inside other models

Naming rule: model names must contain only alphabetic characters — no spaces, digits, or symbols. Use PascalCase, e.g. WorkOrder, not Work Order 2.

Steps

1. Go to Left menu → Schema & GraphQL → Data Models. (Fallback: header Search "Data Models".)
2. Click +. The Create a new Data Model dialog opens.
3. Type the Name (alphabetic only, e.g. Asset).
4. Type a Description.
5. Pick the Data Model Kind (Reference or Embeddable).
6. Click the orange +. You land on the model's detail page.
7. Click the screen icon (🖥) in the toolbar to open the model in the Schema Designer, where you add fields (Toolbox → Field) on the canvas.
8. Back on the model detail, open the VERSIONS tab, click + to create a version, then click ⬆ to deploy it. The model is live only after a version is deployed.

Check your work

The Data Models table shows your model with a Current Deployment, the DATA MODELS KPI tile on Home counts it as deployed, and its generated Query/Mutation types appear in the GraphQL API Explorer's Documentation Explorer.

If creation fails with an "Error modifying data" toast, click the bell icon → the Activity entry explains why — most often the alphabetic-only name rule.

Try it yourself

Create a Reference model named TrainingAsset, open it in the Schema Designer, then delete the model from its detail page (trash icon).

Related training

Training: Explore the GraphQL API · Training: Add a Custom Field · Training: Navigate the Application Designer