Statamic Blueprints and Fieldsets Setup

Statamic Blueprints and Fieldsets Setup

Blueprints are field schemas for Collections, Globals, Taxonomies, Users. Fieldsets are reusable field groups imported into Blueprints.

Blueprint

# resources/blueprints/collections/blog/post.yaml
title: Post
sections:
  main:
    display: Main
    fields:
      - handle: title
        field:
          type: text
          required: true
          display: Title
          instructions: Used as H1 and og:title

      - handle: content
        field:
          type: bard
          display: Content
          sets:
            article_sets:
              display: Article
              sets:
                pull_quote:
                  display: Pull Quote
                  fields:
                    - handle: quote
                      field: { type: text }
                    - handle: attribution
                      field: { type: text }
                code_block:
                  display: Code Block
                  fields:
                    - handle: language
                      field:
                        type: select
                        options: [php, javascript, python, bash, yaml, json]
                    - handle: code
                      field: { type: code }

      - handle: featured_image
        field:
          type: assets
          container: assets
          max_files: 1
          display: Featured Image
          validate: [image]

  sidebar:
    display: Sidebar
    fields:
      - handle: categories
        field:
          type: terms
          taxonomies: [categories]
          max_items: 3

      - handle: author
        field:
          type: users
          max_items: 1

      - import: seo
        prefix: seo_

Fieldset — Reusable Fields

# resources/fieldsets/seo.yaml
title: SEO
fields:
  - handle: title
    field:
      type: text
      display: SEO Title
      instructions: If empty — uses main title
      character_limit: 70

  - handle: description
    field:
      type: textarea
      display: Meta Description
      character_limit: 160

  - handle: og_image
    field:
      type: assets
      container: assets
      max_files: 1
      display: OG Image
      instructions: 1200×630px, used in social networks
      validate: [image]

  - handle: canonical_url
    field:
      type: text
      display: Canonical URL
      instructions: Leave empty for automatic canonical

  - handle: noindex
    field:
      type: toggle
      display: Hide from Search Engines
      default: false

Importing Fieldset into Blueprint:

# In Blueprint section
- import: seo        # fields without prefix
- import: seo        # with prefix
  prefix: seo_

Statamic Field Types

Setting up Blueprints for 5–8 collections with reusable Fieldsets — 1–2 days.