Button Box 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.
Features
- 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.
Field Types
- Action Links
- Position
- Rating
- Visual Choice
- Visual Multi-Choice
- Width
Installation Instructions
To install this plugin, copy the command above to your terminal.
Reviews
This plugin doesn't have any reviews.
Active Installs
2,123
License
MIT
Last release
November 11, 2026
Activity (30 days)
10
Closed Issues
0
Open Issues
0
Merged PRs
0
Open PRs





