Introduction
Usage
Once configured, your editors & publishers will see inline previews of existing matrix blocks as well as a pop-up modal when adding new blocks.
Inline Previews
When editing entries in the Craft CMS control panel, there will now be "inline" preview images for all matrix field blocks. These are small thumbnail images alongside the title & description:
These are useful to give editors a visual reminder of what each block looks like on the page. Each thumbnail can be hovered-over to see the full thumbnail image:
Modal Overlay
When your editors are working on matrix fields, the button for adding a new block to the field will now launch a modal overlay:
This overlay has a few features:
- The matrix field blocks. These are all of the blocks available the matrix field being edited. Editors will see a preview screenshot, a title and a short description (if added).
- Search input. Editors can search through blocks by title or description. This field is autofocused by default for efficiency.
- Category filters. The lefthand sidebar displays the categories that have been configured, allowing editors to narrow down their search to particular types of content.
Takeover
By default, the Matrix Field Preview modal will replace the default "add block" button.
This is called "takeover". If disabled, instead of completely replacing the button, an additional "content preview" button will appear beside the "add block" button:
