Skip to content
LogoLogo

Models

A Model is a reusable schema. It sets which fields a piece of content can hold, and it holds no data itself.

The models list in the schema builder on the Picked dashboard

Where a Model appears

CMS in the sidebar holds Models, and that list shows every Model in the workspace. The list shows the Key below the name, because the key is the value that a schema holds.

Two shortcuts open a filtered subset of the same list. Flows holds Step Layouts, and Pages holds Page Layouts.

Category

A category gives a Model a role. It decides where the Model appears, and what renders an entry that comes from it.

CategoryIt gives its shape toWhat renders it
Page layoutA standalone Page.The SDK renders the entry on your server.
Step layoutOne Step inside a Flow.The Step renders the entry in the browser.
None (general content)Content with no layout role.Nothing renders it directly. A reference field reaches it.

A Model with no category holds content that other content points at, such as a product or a category. It appears under CMS only.

Field types

A Model is built from fields. Each field has a type. The type decides the editor for the field, and the shape of the value that the field holds.

TypeHoldsUse it for
Single line textA short string.A title, a label, or a short headline.
Multi-line textA longer plain string.A description, or a paragraph with no format marks.
MarkdownA Markdown string.Body copy with format marks.
SlugA URL-safe string.A part of a path, or an identifier.
NumberA numeric value.A price, a count, or a rating.
BooleanA true or false value.A toggle or a flag.
DateA date value.A publish date or a deadline.
ColorA color value.A theme accent or a swatch.
JSONAny JSON value.Structured data with no editor of its own.
GroupAn object of fields inside the Model.A set of related fields, held together.
Content blockA Block schema inside the Model.A shared schema fragment that you reuse.
Page SectionsA repeatable Content block field, limited to the Section category.The section list of a page.
ReferenceA pointer at another content entry.A product that points at its category.
AssetA link to an Asset Library item.An image, a video, or a document.
HTMLA link to a .html file in your library.HTML that you wrote before, held inside the content.

Reference fields

A Reference field points at another content entry. The entry that you point at keeps its own data, and many fields can point at the same entry.

OptionValuesWhat it does
Target ModelA Model, or Any ModelLimits which entries an editor can choose.
RepeatableOn or offOn gives an ordered list of entries. Off gives one entry.

Target Model holds the key of the Model, and not its id. A duplicate of the workspace therefore keeps the constraint.

A reference stays inside one workspace. A field cannot point at an entry in another workspace, and Picked reports such a target as unknown.

Repeatable and grouped fields

You can make any field repeatable. It then shows as a sortable list of values, and not as one value. Use it for a gallery, for a list of features, or for any collection.

A Group field holds a set of fields under one key, and it gives a structured object. Make a group repeatable to describe a list of objects, such as a list of feature cards.

Delete rules

Picked does not delete a Model while something still needs it.

ConditionResult
Content entries still belong to the ModelThe delete stops.
A Reference field still holds the Model as its Target ModelThe delete stops.