Field Types Reference

Single-line plain text field. Use for titles, names, slugs, and short descriptions.

{ "name": "title", "type": "short-text", "required": true }

Multi-line plain text field. Use for descriptions, notes, and longer content without formatting.

{ "name": "description", "type": "long-text" }

Full rich text editor with formatting support (bold, italic, headings, lists, links). Returns formatted content.

{ "name": "body", "type": "rich-text" }

Integer or decimal number. Use for prices, quantities, ratings, and numeric values.

{ "name": "price", "type": "number", "min": 0 }

True/false toggle. Use for flags like published, featured, inStock, isActive.

{ "name": "published", "type": "boolean", "defaultValue": false }

Date and/or time picker. Stored as ISO 8601 string. Use for publishedAt, createdAt, expiresAt.

{ "name": "publishedAt", "type": "date", "includeTime": true }

Single or multiple media assets (images, videos, PDFs, etc.) from your Media Library. Returns URLs and metadata.

{ "name": "coverImage", "type": "media", "allowedTypes": ["image"] }

Array of simple primitive values (strings, numbers). Use for tags as plain strings, keywords, or simple scalar collections. Do NOT use for arrays of objects — use references-many instead.

{ "name": "keywords", "type": "list" }

Links to a SINGLE entry of another content model. Use when the source data is a nested object (e.g. { id, name, bio }). Examples: author, category, primaryTag.

{ "name": "author", "type": "reference", "settings": { "targetContentTypeId": "author_content_type_id" } }

Links to MULTIPLE entries of another content model. Use when the source data is an array of objects (e.g. [{ id, name }, ...]). Examples: tags, relatedPosts, productVariants. Never use "list" for arrays of objects.

{ "name": "relatedPosts", "type": "references-many", "settings": { "targetContentTypeId": "post_content_type_id" } }

What is a Reference?

A reference field creates a link between one content entry and another. Think of it like a foreign key in a database — it points to another piece of content. There are two types:

// Nested object → reference
"author": { "id": "...", "name": "..." }

// Array of objects → references-many
"tags": [{ "id": "...", "name": "..." }]

How to Add a Reference Field

Adding a reference field in the Contensa.ai dashboard is straightforward:

1. 1

   Open your content model

   Navigate to the content model where you want to add the reference field.

2. 2

   Click "Add Field"

   Choose either Reference (for single linked entry) or References Many (for multiple linked entries).

3. 3

   Configure the field

   Give it an API name (e.g., author) and select the target content type to reference.

4. 4

   Set options

   Mark as required if needed to ensure the field must be filled when creating content.

5. 5

   Save the field

   The reference field is now available when creating or editing content entries.

// Single reference — nested object in source data
contensa_create_field({
  contentTypeId: "blog-post-ct-id",
  name: "author",
  kind: "reference",
  settings: { targetContentTypeId: "author-ct-id" }
})

// Multiple references — array of objects in source data
contensa_create_field({
  contentTypeId: "blog-post-ct-id",
  name: "tags",
  kind: "references-many",
  settings: { targetContentTypeId: "tag-ct-id" }
})

Common Use Cases