Field design rules
Start with the question the field answers. A field called Category answers which group an item belongs to; a field called Gold Text does not describe content and will become difficult to maintain.
- Use plain text for titles, labels and short values.
- Use rich text for structured editorial copy that needs headings or links.
- Use images for content assets rather than pasted URLs where possible.
- Use dates for publishing and event dates so sorting stays reliable.
- Use references for relationships instead of repeating the same author or category text.
Connect fields to the interface
Follow the sequence below from start to finish. The order matters: later steps assume the earlier ones are done.
- Select the text, image or link layer in the CMS-connected component.
- Choose the matching collection field from the content connection menu.
- Preview several records, including the longest title and an empty optional field.
- Add a deliberate fallback or conditional treatment for optional content.
Field naming checklist
A few moving parts are involved here. The points below cover each of them, so you can see the full scope before deciding where to start.
- Use singular, plain-language names.
- Keep one meaning per field.
- Document units for numbers, prices and durations.
- Avoid duplicate fields with slightly different names.
Handover notes for editors
When a collection goes live, give editors a short field guide: what each field is for, whether it is required, and any character limits imposed by the layout. This prevents an editor filling a summary field with three paragraphs and breaking a card layout months after launch.
Common field mistakes
This comes down to a handful of concrete details. Work through the list below and flag the ones you have not covered yet.
- Storing a colour or icon choice in a text field instead of a controlled option.
- Using a rich text field for a single short label, which allows accidental formatting.
- Adding a boolean called Type1 instead of a readable option like Featured.
- Leaving a field required when it is genuinely optional for some records.