Installation & Setup
Requirements
Configuration
What is Vizy?
Field Settings
Block Based Editor
Rendering Content
Modify Nodes
Querying Nodes
Modular Templates
Block Type Templates
Extending Vizy
Events
Node
Mark
Node Collection
GraphQL
Developers
Changelog
3.2.4 2026-08-10
Fixed
Fix Feed Me TypeError when Vizy field values are quoted plain text. #375.
3.2.3 2026-07-27
Fixed
Fix nested Matrix "+ New entry" 403 when the Vizy field sits inside a Neo (or other nested) block.
Fix MatrixAnchor duplicate-key IntegrityException on multi-site saves when the anchor is missing a site the owner covers. #373.
Fix Craft 5 upgrade migrations crashing when the vizy_matrix_anchors table hasn’t been created yet. #372.
3.2.2 2026-07-15
Added
Fixed
Fix migration handling for some Vizy Block fields like Hyper and Typed Link fields in Hyper.
Fix nested Matrix "+ New entry" 403 by resolving parent owner from MatrixAnchor ownerId.
3.2.1 2026-06-27
Added
Add vizy/anchors/backfill console command to proactively migrate Matrix+Vizy content.
Fixed
Fix performance issues with Matrix Anchor handling.
Fix matrix anchor race condition in load-balanced environments.
3.2.0 2026-06-20
Fixed
Fix Craft 5 Matrix-in-Vizy persistence via MatrixAnchor elements and portal-to-JSON save sync.
3.1.8 2026-05-30
Fixed
Fix Matrix content filtering for malformed block values.
Fix vizy/content/fix-vizy-block-field-uids not repairing nested Vizy block field content.
3.1.7 2026-05-10
Fixed
Fix an issue with Vizy Blocks containing a Table field not preserving sort order.
3.1.6 2026-04-30
Changed
Update tiptap and qs dependencies.
3.1.5 2026-04-11
Added
Add automatic “mailto” handling for links that are emails.
Fixed
Fix whitespace-only text nodes not preserving spaces between marks.
3.1.4 2026-03-24
Fixed
Fix an issue where blocktype definition could be lost when rendering Vizy fields.
Fix Vizy Block preview not persisting on page reload.
3.1.3 2026-03-15
Changed
Refactor Vizy field bootstrapping to DOM auto-mount.
Fixed
Fix Vizy Block content not being consistently site-aware.
Fix an error for CKEditor 5+ and other plugins using registerScriptWithVars().
3.1.2 2026-03-03
Added
Add vizy/content/fix-vizy-block-field-uids console command to assist with some migration issues for missing field layout fields in Vizy Blocks.
Fixed
Fix Vizy Block’s not normalize content when stored with deprecated field handles.
3.1.1 2026-02-07
Added
Add support for importing Vizy Blocks for Feed Me feeds. Still requires constructing payload manually.
Add support for Craft Content Block fields within Vizy Blocks.
3.1.0 2026-01-25
Changed
Revamp Vizy Block field rendering to use DOM portals, rather than within Vue/Tiptap directly.
Fixed
Fix Vizy Block’s containing selectize dropdowns not working correctly when moving blocks.
3.0.14 2026-01-23
Added
Add Link Settings to Vizy fields to allow control of what settings a Link button has access to.
Fixed
Fix handling of corrupted list items not being normalized properly.
3.0.13 2025-11-29
Changed
Improve content-encoding handling for special-characters, HTML content, emoji’s and more.
Fixed
Fix empty text nodes not being filtered out correctly.
3.0.12 2025-11-06
Changed
Improve change-detection checks for Vizy Blocks.
Fixed
Fix an issue for Vizy Blocks that contained relational fields, when the fields were eager-loaded.
Fix an issue for Table nodes, where attributes set on table were also set on tbody.
3.0.11 2025-09-16
Changed
Update migration-mode check.
Fixed
Fix an error for some field content, that appeared JSON-like, but wasn’t error-handled gracefully.
3.0.10 2025-07-18
Added
Add support for programatically creating Vizy Block content with the Vizy Block Type handle.
Fixed
Fix extra-small lightswitch style.
Fix an error migrating Vizy 1 content containing Vizy Block fields with <iframe> content.
Fix Super Table migration from Craft 4 handling.
3.0.9 2025-05-20
Changed
Vizy Blocks now only validate enabled blocks.
Fixed
Fix an error with Live Preview and some buttons (link, iframe, image).
Fix an error for some nodes by not normalizing raw content.
3.0.8 2025-05-01
Added
Add Vizy field context to block templates.
Add Craft 5 content migration for Vizy fields that contained Super Table fields.
Fixed
Fix an error when changing field layout fields in Craft 5.7+.
Fix lightswitch UI for Craft 5.7+.
Fix collapsed Vizy block’s truncated text overflow.
Fix a namespace issue for Vizy block fields.
Fix an error when migrating content for prefixed databases.
3.0.7 2025-03-05
Fixed
Fix handling of some complex fields, where their content wasn’t being JSON-decoded.
3.0.6 2025-02-02
Added
Add Node::EVENT_MODIFY_RENDERED_NODE event to modify the fully rendered HTML of a node.
Add back content migration for some fields to use (Hyper).
Changed
Disable Matrix, Neo and Super Table fields from being able to be included in Vizy blocks, until proper support has been added.
Improve source map bundle size.
Update icons to Font Awesome 6.
Update the element selector window for element-based links to only show the site menu for multi-site installs.
Refactor change-handling to better deal with Craft 5 ElementEditor updates and other fields.
Fixed
Fix an error with element select fields in Craft 5.6+ when used in a Vizy block.
Fix Vizy Block settings icon alignment.
Fix an error when handling Matrix blocks in Vizy blocks.
Fix an error when creating new Vizy Blocks for Vizy fields.
Fix Db::prepareForJsonColumn deprecation and handling.
3.0.5 2024-11-14
Fixed
Fix listenForChanges check to include certain elements (element fields) which would prevent click event detection.
Fix an error when editing a Vizy field within another field’s layout, in the slide-out pane.
Fix duplicate Bold extension registration for editor.
Fix fixed toolbar not working in element editor slideout.
Fix compatibility with Hyper 2.1.x.
Fix a Craft 5.5+ incompatibility.
3.0.4 2024-10-09
Added
Add support for modifying nested nodes through Twig (for Table nodes).
Add support for entry/category/asset custom sources when picking links.
Add vizyInput as a callback parameter when registering custom extensions/buttons/commands in JavaScript.
Changed
Update custom-registered Vizy extension registration format.
Fixed
Fix an error when inserting links on non-multi site installs.
Fix an error when trying to deserialize HTML content.
Fix Vizy Block group name being incorrectly saved as uppercase.
Fix custom-registered Vizy extensions being globally enabled for all Vizy fields.
3.0.3 2024-08-14
Fixed
Fix an issue with multiple Vizy editors with different formatting or table configs.
Fix buttons styles not working correctly.
3.0.2 2024-08-11
Fixed
Fix some click events in Vizy Block fields not triggering change event listener.
Fix an error when initializing Vizy fields multiple times.
Fix incorrect field serialization when in live preview.
Fix Live Preview detection.
Fix compatibility with Hyper.
3.0.1 2024-07-21
Added
Add the ability to set links to current site, or specific site for element-based links.
Changed
Change change-detection mechanism incorrectly flagging changed JSON due to discrepancies with PHP vs JS JSON encoding.
Fixed
Fix an error when creating search indexes.
Fix default site for Link nodes.
Fix Image node URLs not being dynamics when non-transforms are selected.
Fix default transform value for Image nodes.
Fix change detection mechanism for Vizy Blocks.
3.0.0 2024-05-18
Added
Add the Craft.Vizy.Config.registerTemplates() JS function for custom extensions to render their own template in a Vizy field.
Changed
Now requires PHP 8.2.0+.
Now requires Craft 5.0.0+.
Update Vizy block header actions to use an ellipsis icon instead of a settings cog.
Vizy block inner custom fields now save custom field content via the field’s layoutElementUid instead of their handle.
Fixed
Fix an error for Image nodes, where the id attribute didn’t reflect an Asset Element ID.
Fix an error when saving Vizy blocks in some scenarios, where blocks incorrectly had an invalid ID.
Fix content changes being detected for nested fields when there are none. In addition, Vizy fields only listen for changes to their content when interacted with.
Fix field layout designer in settings not serializing changes correctly.