Think of blueprints as stencils for your content. They control what fields users get to work with when publishing content, as well as the schema of the data developers will be tapping into to build the front-end of your site. Blueprints can be attached to collections, global sets, assets, users, and even forms.
You can create blueprints in the Blueprints area of the control panel or by creating a YAML file in
resources/blueprints/. Once created, you can begin to define fields and the sections that hold them. If you have more than one section, each becomes a tab in the publish form.
It’s possible to have fields be displayed only under certain conditions. For example, you may only want to show a caption field if an asset field has an image selected, or a whole block of fields if a toggle switch is enabled.
To learn what’s possible and how implement the various rules, head over to the article on conditional fields.
At its most basic, a blueprint has a title and an array of sections.
title: My Blueprint sections: 
A section has a handle, a display name, and an array of fields:
sections: main: display: Main fields: - handle: content type: markdown meta: display: SEO Metadata fields: - handle: meta_title type: text - handle: meta_description type: textarea
Unlike fieldsets, blueprint fields are sequence indexed instead of keyed by handle. This format allows maximum flexibility: you can reference fields from other blueprints one or more times, override their settings inline, and even reference existing fields for Bard, Replicator, and Grid sets.
A section’s fields can be comprised of references to fields in fieldsets (so you can reuse fields) or inline field definitions.
You will likely want to pre-configure reusable fields that you can pull into your blueprints.
For example, you might have a rich text field configured with all your favorite buttons, which you’ve called
content and stored in the
You can pull it into your blueprint like so:
fields: - handle: my_content_field field: common.content - handle: another_content_field field: common.content
This way, you are free to reuse the same field as many times as you like. Update the field in the fieldset and it will be reflected across all your blueprints.
You may customize a referenced field by adding a
config array. Any keys found in this will override whatever was defined in your fieldset.
fields: - handle: my_content_field field: common.content config: display: My Content Field validate: required|max:200
validate would replace whatever was defined in the fieldset.
Note: This only applies to referenced fields. For inline fields, you can just set everything right there.
Fieldsets still exist in Statamic 3! They serve to create reusable sets of fields, just like v2. You may import an entire fieldset at any point by using the
import key, for example:
# blueprint fields: - import: survey prefix: favorite_ - import: survey prefix: least_favorite_
# the survey.yaml fieldset fields: food: type: text food_reason: type: textarea
Doing the above would result in a blueprint like this:
fields: - handle: favorite_food field: type: text - handle: favorite_food_reason field: type: textarea - handle: least_favorite_food field: type: text - handle: least_favorite_food_reason field: type: textarea
It would bring every field inline and prefix each field’s handle appropriately.
If you omit the
prefix you won’t be able to import them more than once at the same level because they would have the same handle and overwrite each other.
The Grid fieldtype lets you define a set of sub-fields, which it will allow you to repeat as many times as you like.
You should define its fields using the blueprint field syntax. This will allow you to reference other fields and/or import entire fieldsets.
links: type: grid fields: - handle: url field: links.url - handle: text field: links.text - handle: external field: links.external
While conditional fields allow you to control field visibility on the publish form, you may also customize column visibility on entry listings in the control panel.
This hides the field column from entry listings, which can be useful for toggle fields etc, which may never make sense in the context of an entry listing.
This will hide the field from entry listings by default, but still allows a user to toggle visibility using the column selector, and save those column preferences for his/her preferred workflow.