Button Box is a Craft CMS plugin that gives authors clear, visual choices while keeping stored values stable and predictable. Build a compact dropdown or button group, a descriptive card picker, a colour or gradient palette, a semantic position grid, a dedicated width control, a whole-number rating, or a multi-choice set without handing editors free-text design tokens.
The plugin styles the Craft control panel only. Your templates remain in charge of public-site markup and CSS, with documented Twig and GraphQL values for each field type.
- Build single- and multi-choice fields with Buttons, Button group, Chips, List, Tiles, Cards, Swatches and Visual samples, plus Dropdown for single choices.
- Attach descriptions, icons, colours, images, categories, disabled states, explanations and typed surface metadata to stable option values.
- Create and customise presets for visual choices, Position, Width and Rating, then copy their settings into independent fields.
- Manage shared option sets in the control panel and project config, convert a reference to local options, or supply options at runtime through PHP events.
- Configure width stops with Bar or Width samples, useful presets and optional labels.
- Capture named positions with spatial metadata and whole-number ratings.
- Reuse conditional Action Links across field layouts with shared button settings.
- Use stored choices in element indexes, cards, search, conditions, sorting and inline editing, with numeric queries for Rating.
- Read typed option and position objects in Twig and GraphQL.
- Preview explicit conversions from Buttons, Colours, Text Size, Width, Stars and Triggers before choosing whether to apply them.
- Action Links
- Position
- Rating
- Visual Choice
- Visual Multi-Choice
- Width
Visit the Button Box Plugin page for all documentation, guides, pricing and developer resources.
Originally created by the team at Supercool Ltd.
Get in touch with us via the Button Box Support page or by creating a GitHub issue.
Button Box is licensed under the MIT license, so it will always be free and open source. If you'd like to support it anyway, you can sponsor its development.