Model fields explained

Use our flexible content model builder to structure your content exactly how you envision it. Whether it's a landing page or voice assistant commands, your options are endless. Prepr is fully customizable for your content needs. Define models for your content using a variety of fields and components.

In this article

To create or edit a model, go to  Settings > Publish > Models. Import a model, create a new model or click on the name to edit an existing model. Choose 'Add field' to select one of the fields. In this article, we will explain all available model fields. You can add up to 100 fields to a model.

Default field settings and options

Every model field contains a variety of basis field settings:

  • Title: the title of this field, shown in the content item as the field label.
  • ID: the technical ID of this field, useful to retrieve the fields with the API.
  • Help text: these texts are an instruction to the editors of your content. You can further clarify the instructions by making text bold, italic, or bolditalic. You can do this by using markdown in the help text. The following markdown is accepted:
    • * and _ (italic)
    • ** and __ (bold)
    • *** and ___ (bolditalic).
  • Show in preview: if this option is enabled, the field will be visible in the preview in the content item sidebar
  • Disable editing: when this field is activated, it is not possible to enter, change or clear this field in a content item. This can be useful when this field is only filled with the API or via an content automation.
  • This field is required: enable the option to make this field mandatory. The validation only takes place on content items that are set to DONE status. This means that you can save content items with empty mandatory fields when the item has a different status. 
Note: Making changes to existing fields may lead to broken content items.

Text field

The text field allows you to add text elements to your content item. Check this page to see the text field explained.

Dynamic content field

A very comprehensive dynamic content editor in content items. Check this page to see this field explained.

Assets

Prepr supports multiple asset types: images, files, videos, and audio files. Select the types which are allowed in content item of this model. Select also the minimum and the maximum number of assets permitted in this field. Learn more about crop and image presets.

The field Content reference allows you to make a reference link from one content item to another. Learn more about parent and child content items.

Tag field

The field Tags allow you to add metadata to your content item. The tags field can be visible in three different states:

  • Free tag entry
  • Taggroup > Autosuggest
  • Taggroup > checkboxes / radiobuttons

If you have de SEO score option selected in a model, tag suggestions will be visible at the free tags input field. The tag suggestions: 

Component field

Components as predefined fields. Use our flexible content model builder to structure your content exactly how you envision it. You can describe components best as 'models in a model': a predefined set of fields.

Users often use elements as a drag-and-drop field. You can use your components as a field as well. Go to  Settings > Publish > Models and add the 'Component field' you like. Your options are endless! Learn more about components.

Element field

Content integration field

The content integration field allows you to reference content in an external CMS, a legacy system of an eCommerce platform. A content Integration allows an editor to easily add items to content items. Prepr will even keep the data in sync automatically. Learn more about content integrations.

Boolean field

A boolean field is a data type that has one of two possible values (usually denoted true and false). In a Prepr model, you can overwrite the default true and false conditions by giving them a name that matches best with your editor's needs.

Initial value

You can prefill the form input automatically by setting an initial value. Enter the value in the model list field; this value can be overwritten manually.

Number field

The number field can be useful when you want to add numerical data to your content item. For example year of birth, stock number, or product prize.

Initial value

You can prefill the form input automatically by setting an initial value. Enter the value in the model text field; this value can be overwritten manually.

List

The list field allows you to make a choice out of the given options. In a model, you can fill in all list items which match best with your organization's needs. Common use cases are list items with a genre or topic.

The Prepr list field contains a key-value option. This allows you to give a list item a technical name (a unique identifier, a key) and a user-friendly value that you see in the Prepr content items (the data, the value).

Initial value

You can prefill the form input automatically by setting an initial value. Enter the value in the model list field; this value can be overwritten manually.

Color

The color field allows you to choose a color. Useful (for example) when you manage your frontend in Prepr. 

Initial value

You can prefill the form input automatically by setting an initial value. Enter the value in the model color field; this value can be overwritten manually.

Date and time

The field Date and time allows you to add date field and date-time fields to your content item. The date type is a date-only field. The date range is date start and date end type. If you want to add a time to your date or date range, select ' Allow extra time selection'. Select 'Allow extra date (ranges)' when you want to use multiple date or date ranges. The business hours type is day and time picker to enter AM and PM openings hours.

Location

The field Location allows you to add Google Maps geo-points (coordinates or an address) to your content item.

Social

Prepr supports several social embeddings. You can select one of them for each social field. In a content item, editors can copy paste a social URL. Prepr will generate a preview of the social post.

Notify

Notifications to content items can be sent as a Prepr content item. To do so, add the notification field to the model you want to use for notifications. To add the notification field, simply click on ' Add field' en select ' Notification'.

It is possible to use group segments when 'customer sharing' is enabled in your Prepr account. Once the notification field is added, you can now notify your customers with Prepr content items. Learn more about Notifications.

Slug

Automatically generate preview links to quickly preview your content. The path to your content item consists of two parts: the domain construct and the slug construct. In Prepr you can easily manage both parts. Go to  Settings > Publish > Models to manage the review URLs. Learn more about working with slugs.

Section

A section is used to create separate groups of elements for your editors. This can be helpful when you want to separate the metadata from your content. Learn more about sections.