NodePress CMS

Repeater — example schema & output

Define sub-fields once, add unlimited rows in the editor. Each item shares the same structure.

// Schema definition
{
  "name": "gallery",
  "type": "repeater",
  "subFields": [
    { "name": "image",   "type": "image", "required": true },
    { "name": "caption", "type": "text" }
  ]
}

// API output — an array of objects
"gallery": [
  { "image": "/uploads/photo1.jpg", "caption": "First photo" },
  { "image": "/uploads/photo2.jpg", "caption": "Second photo" }
]

Flexible — example schema & output

Each item in the list can be a different layout — perfect for page builders. The _layout key tells you which block type it is.

// Schema definition
{
  "name": "sections",
  "type": "flexible",
  "layouts": [
    {
      "name": "hero",
      "label": "Hero Banner",
      "fields": [{ "name": "heading", "type": "text" }]
    },
    {
      "name": "text_block",
      "label": "Text Block",
      "fields": [{ "name": "body", "type": "richtext" }]
    }
  ]
}

// API output — _layout tells you which block type it is
"sections": [
  { "_layout": "hero",       "heading": "Welcome to NodePress" },
  { "_layout": "text_block", "body": "<p>Some content here</p>" }
]

Group — example schema & output

A fixed set of sub-fields stored as a single nested object. Unlike repeater, there is no list — just one object. Perfect for SEO metadata, address blocks, or social links.

// Schema definition
{
  "name": "seo",
  "type": "group",
  "subFields": [
    { "name": "title",       "type": "text" },
    { "name": "description", "type": "textarea" },
    { "name": "og_image",    "type": "image" }
  ]
}

// API output — a single nested object, not an array
"seo": {
  "title": "My Post",
  "description": "A short summary of my post.",
  "og_image": "/uploads/og-cover.jpg"
}

Relation — example schema & output

Links entries across content types using their publicId UUID. Use ?populate=fieldName to inline the full related entry instead of just the UUID.

// Schema definition
{
  "name": "author",
  "type": "relation",
  "options": {
    "relatedContentType": "team",
    "cardinality": "one"
  }
}

// Default API output — returns the publicId UUID
"author": "a1b2c3d4-e5f6-4abc-8def-000000000001"

// With ?populate=author — returns the full entry inline
"author": {
  "slug": "jane-doe",
  "data": { "name": "Jane Doe", "role": "Editor" }
}

// cardinality: "many" — array of UUIDs or populated entries
"tags": ["uuid-1", "uuid-2"]