Skip to content
Docs
    Menu

    Content (CMS)

    Object types and mixed lists

    Explains reusable groups of fields and lists whose entries can be different kinds.

    Object types

    An object type is a group of fields you can reuse. An "Address" with street, city and postcode is a typical example. Once it exists, any collection can use it, and so can other object types.

    To see your object types, open the CMS view and switch from Collections to Object Types. From there you can:

    • Create one with New object type (or Create your first object type). Give it an Object type name, add fields, and pick a Title field, which is "Shown as each one's name in tables and lists."
    • See where it's used under Used in.
    • Turn a group of fields that already lives inside a collection into an object type. Groups like this appear under Found in collections. Open one and click Make reusable.

    To use an object type in a collection, open Edit Schema, set a field's type to Object, and choose the object type from Custom object.

    Object types are shared, not copied

    A field that uses an object type stays linked to it. When you change the object type, every field that uses it changes too. In the collection, the field lists the object type's fields with the note "Edit these in the object type."

    You can't delete an object type while any field uses it. The delete dialog says how many fields use it.

    Mixed lists

    A normal list holds entries of one kind, such as a list of tags or a list of team members.

    A mixed list holds entries of different kinds. A page-builder-style "sections" field is the classic case: one entry is a quote, the next is an image with a caption, the next is a call to action.

    To make one, add a List field in Edit Schema, choose Several item types, then use Add item type to add each kind. Each kind can have its own fields (Custom fields) or use an object type.

    In the item editor, + Add item on a mixed list asks which kind to add. Each entry shows its number and kind.