Model Schemas

Last edit: Aug 27, 2019

What is Model Schema?

Model Schema is an object that describes all Model objects that belong to it.

You can think of it as a DB table, whereas Models are records inside this table - hence Model must always be associated with exactly one CustomModelType.

Model Schemas define object types that will exist in your application. They describe the properties each object can have. For example, if you want your application to manage "books", you can create a Model Schema with the name "book" that will have the properties "title" and "author" (both having the type "string"). Individual books in your application will be "model" objects tied to this custom model type, and you will be able to set actual values for the "title" and "author" of each book.

To fully understand Model Schemas you first need to understand basic functions of Model objects which is to create, read, update, and delete data. The organization of how this data is structured within Model and persisted in our backend systems is defined by Model Schema files.

Head to the Persisting Data With Model tutorial to fully understand the process based on a todo list example.

Model Schemas use cases

  • Think of them as a custom DB table, which allows you to build highly customized features.
  • Use them to group Properties, and allow the user to provide multiple values for each of them.

For example, you can build a table that will store a user's favorite books. Each book has an author, title and a number of pages. These three fields are Properties. That’s why you can use Model Schema to group Properties.

Now you can build a form that allows users to add multiple books attached to their user profile (using GraphQL).


Model Schemas are placed in the model_schemas directory.

The example below shows the BlogPost Model Schema model_schemas/blog_post.yml:

name: blog_post
- name: title
  type: string
- name: content
  type: text

Configuration Properties

Property Description Required
name Name of your model. Best practice is to keep it lower case. Example: user_application Yes
properties Array of properties you want to contain within your models. Equivalent to a column in a database table. No


Model Schemas work well with Forms. For detailed description and all available options see the following topic:

Related topics


We are always happy to help with any questions you may have.