Changelog

2.1.31 2026-05-10

Fixed

• Fix an issue with Vizy Blocks containing a Table field not preserving sort order.

2.1.30 2026-04-29

Changed

• Update tiptap and qs dependencies.

2.1.29 2025-09-16

Changed

• Update migration-mode check.

2.1.28 2025-07-18

Fixed

• Fix an error migrating Vizy 1 content containing Vizy Block fields with <iframe> content.

2.1.27 2025-05-20

Changed

• Vizy Blocks now only validate enabled blocks.

2.1.26 2025-05-01

Added

• Add support for utf8mb4 encoded values.
• Add Vizy field context to block templates.

Fixed

• Fix an error with Vizy blocks containing relation fields.
• Fix migration from Craft 3, where special characters and HTML entities weren’t being decoded and content not correctly sanitized.
• Fix an error when using relation fields like Assets in Vizy blocks.

2.1.25 2025-02-02

Added

• Add Node::EVENT_MODIFY_RENDERED_NODE event to modify the fully rendered HTML of a node.

2.1.24 2024-11-14

Fixed

• Fix listenForChanges check to include certain elements (element fields) which would prevent click event detection.

2.1.23 2024-10-09

Added

• Add support for modifying nested nodes through Twig (for Table nodes).

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.

2.1.22 2024-08-14

Fixed

• Fix an issue with multiple Vizy editors with different formatting or table configs.
• Fix buttons styles not working correctly.

2.1.21 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.

2.1.20 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.

2.1.19 2024-04-29

Changed

• Update Tiptap dependancies.

Fixed

• Fix element owner checks.
• 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 an error when re-ordering Vizy blocks with Asset fields.

2.1.18 2024-04-10

Added

• Add the Craft.Vizy.Config.registerTemplates() JS function for custom extensions to render their own template in a Vizy field.

Fixed

• Fix an error for Image nodes, where the id attribute didn’t reflect an Asset Element ID.

2.1.17 2024-03-18

Fixed

• Fix an error with content not saving when two Vizy fields with Block-only and Rich Text configs are present.

2.1.16 2024-02-29

Changed

• Update Vue.js version for some compatibility fixes.
• Update all Tiptap dependencies for the latest and greatest features/fixes.

Fixed

• Fix CKEditor issue when moving Vizy Blocks.
• Fix an error when importing Vizy content with Feed Me, when field content is empty.
• Fix YouTube live URLs for media embed function.
• Fix Selectize fields not working properly when re-ordering Vizy blocks when contained in a Matrix/Super Table field.
• Fix spacing of non-full-width fields in Vizy blocks.
• Fix text overflowing issue in editor when no newlines were present.

2.1.15 2024-01-30

Fixed

• Fix inline JS scripts for some fields throwing fatal Vizy Block errors.
• Fix tooltip for Image nodes not appearing when clicking on, in some instances.
• Fix extra CSS and JS generated by block types not being extracted out for new blocks.
• Fix an error when clicking on a link to edit its setting, when wrapped in other nodes or marks.

2.1.14 2023-12-08

Added

• Add NodeInterface::contentNodes for GraphQL node queries for getting nested content nodes/marks.

Fixed

• Fix Vizy fields not saving when they contained a Neo field.
• Fix NodeInterface::marks to actually return the marks of a node.
• Fix an error for Hyper fields with element custom fields, not saving correctly.

2.1.13 2023-11-25

Added

• Add console log for fatal Vizy block renders to assist with debugging.

Fixed

• Fix fatal Vue errors when inline <style> tags were included in Vizy block field rendering.
• Fix error state for invalid Vizy blocks.
• Fix and improve click and mouse events inside a Vizy block, due to drag-handling from Tiptap.
• Fix an issue where fields in a Vizy block couldn’t be focused, due to a Craft 4.5.7 change.
• Fix an error with code block nodes escaping code content.

2.1.12 2023-10-25

Added

• Add exception message to console when failing to render a Vizy block.

Fixed

• Fix an error when outputting iframe content, in some cases.

2.1.11 2023-10-03

Fixed

• Fix HardBreak (<br>) nodes being rendered twice.
• Fix an issue where some fields (Hyper) in Vizy blocks weren’t being serialized properly.

2.1.10 2023-09-25

Added

• Add better handling for fatal errors when rendering Vizy blocks.

Fixed

• Fix Table node inner node styles (links, lists, etc).
• Fix when using the Image Editor on an Image node, transforms not being generated.

2.1.9 2023-09-08

Added

• Add normalization fix for incorrect ListItem schema format.
• Add title setting to Link nodes.

Fixed

• Fix an issue with project config and other new fields.
• Fix using Hyper and Icon Picker fields in Vizy blocks.
• Fix ListItem normalization.
• Fix an error with node normalization.
• Switch htmlEncode for AntiXSS for better special character handling.
• Fix Table nodes’ rendering.
• Fix node normalization not completing correctly for nested nodes.
• Fix field not initializing correctly in Super Table or Matrix field settings.
• Fix rel output for links.
• Fix overlapping marks not producing the correct HTML output.

2.1.8 2023-08-10

Fixed

• Fix rendering nested JS for Vizy fields.
• Revamp Vue component initialization for input and settings. Improves performance and edge-cases with Vizy fields nested in Matrix/Neo/Super Table and nested Vizy fields.
• Fix an issue where nested Vizy fields trigger an unload warning.
• Fix GQL schema for Nodes to generating correctly.
• Fix Super Table/Matrix/Neo nested combinations not rendering Vizy fields correctly.
• Fix an issue for neste Vizy fields, and isNew checks.
• Fix an issue where deeply-nested Vizy fields within Matrix or Super Table fields weren’t having their content set correctly.
• Fix lightswitch UI for Vizy blocks on Craft 4.4.16+.
• Fix “fresh” check for blocks, affecting some defaults for some fields (Button Box) saving over content.
• Fix the media embed node not displaying correctly when toggling the code editor.
• Fix ListItem nodes throwing an error when their content was null.

2.1.7 2023-07-11

Added

• Add error class to Vizy Block tabs, when one of their fields has an error.

Fixed

• Fix an error parsing empty table field nodes.
• Fix an error when Vizy Blocks contain a dismissable UI element tip.
• Fix Matrix-nested fields and spacing.

2.1.6 2023-05-27

Fixed

• Fix new Vizy blocks not having their isFresh set for new fields.

2.1.5 2023-05-17

Added

• Add recursiveFieldCount plugin setting.

Fixed

• Fix an error when no blocktypes are defined for a blocktype group.
• Fix an issue when new nested Vizy fields would wipe out other fields’ unsaved draft content.
• Fix incorrectly hijacking click events inside Vizy blocks.
• Fix an error for Media Embed nodes when containing special characters in embed data HTML.

2.1.4 2023-05-03

Changed

• Improve gap cursor between Vizy blocks.

Fixed

• Fix an error when editing nested Vizy fields in element slide-outs.
• Fix an issue where nested Vizy fields (Vizy > Matrix > Vizy) weren’t working correctly.
• Fix iframe nodes not rendering correctly.

2.1.3 2023-04-24

Changed

• Lower the font size of preview text for Vizy Blocks.
• Update all JS dependencies.

Fixed

• Fix Vizy block preview text not using correct values for some field types.
• Fix an error when re-ordering certain Vizy blocks, containing nested Vizy fields.
• Fix collapse transition with nested Vizy fields and the editor toolbar.
• Fix dropdown fields used in Vizy blocks rendering incorrectly when moving.
• Fix incorrect Table handling for Feed Me.
• Fix Redactor fields in nested Vizy fields getting reset (removed) when they shouldn’t.

2.1.2 2023-04-20

Fixed

• Fix being unable to select an image when no default transform was set for the field.

2.1.1 2023-04-19

Added

• Add Table support for Feed Me.
• Command Palette commands can now be part of the Editor Config.

Changed

• Command Palette commands now filter out any extensions that are included, but don't have a button enabled.

Fixed

• Fix ul/ol items being invalid in the editor and saved incorrectly. May require any items added after 2.1.0 to be re-input.
• Fix some users not being able to link to assets.

2.1.0 2023-04-13

Added

• Add the ability to provide your own buttons, commands and extensions.
• Add support for Editor Config custom buttons.
• Vizy fields can now be included recursively (up to 10 levels of the same field).
• Add Media Embed node.
• Add Table node.
• Add iFrame node.
• Add TextStyle mark for creating span elements related to text styles.
• Add “Editor Mode” field setting to control whether block-only, rich-text-only or combined.
• Add “Commands Palette” to make creating content super-speedy. Just start typing “/“ anywhere.
• Add “Block Type Picker Behaviour” field setting to control whether having the block-picker shown on click or hover.
• Add “Expand All” and “Collapse All” option to Vizy blocks.
• Add data-block and data-type attributes to Vizy blocks.
• Add Ctrl/Cmd + K as a keyboard shortcut to add new links.
• Add “Plain Text Paste” field setting.
• Add “Classes” setting to Link nodes.
• Add “Min Blocks” and “Max Blocks” settings to field.
• Add “Min Blocks” and “Max Blocks” settings to each Vizy block type.
• Add LinkMarkInterface for Link Marks for GraphQL queries.
• Add proper support for Marks in GraphQL queries.
• Add Link::getLinkElement().
• Add the ability to set a default source for images uploaded to the field.
• Add keyboard accessibility to menu button dropdowns.
• Add the ability to set render variables on the node with node.renderHtml(config) or node.renderNode(config).
• Add keyboard support to block type picker.
• Add better ghost image when dragging Vizy blocks.
• Add support for disabling max picked blocks from the block-picker.
• Double-clicking a Vizy block now toggles its collapsed state.
• Add Node::normalizeNode to allow nodes to be normalized from the database.
• Add values to VizyBlockInterface for GraphQL.

Changed

• Now requires Craft 4.4+.
• Update all JS dependancies.
• Update Tiptap to 2.0.
• Remove Vizy block focus state (for now).
• Refactor nested Vizy fields to correctly render with Vue 3 compilation, fixing lots of pesky issues.
• Formatting buttons (headings, blockquote, etc) can now be included outside of the formatting dropdown.
• Ordered/Unordered Lists nodes now longer wrap content with Paragraph nodes.
• Refine heading styles in the editor.
• Update NodeInterface::text to return a textual representation (plain text) of any content for GraphQL.
• Modifying other Craft fields included in Vizy fields now correctly updates content when fields’ handles are changed.
• Improve visibility of dropcursor when dragging Vizy blocks.
• Speed up tippy overlays for snappier feedback.
• Change top-level Paragraph node button icon.
• Move asset-related field settings to hidden “advanced” area for brevity.
• Update text align buttons to show isActive state.
• Provide better handling of invalid Vizy blocks if they occur.

Fixed

• Fix modified field status badge for Vizy block fields.
• Fix field triggering a changed value behaviour (saving a new draft) when no content has changed.
• Fix edit image modal alignment and overflow scrolling issues.
• Fix settings cog color for Vizy blocks.
• Fix tab overflow issue for Vizy blocks.
• Fix missing translations for block settings.
• Fix toolbar button alignment issue for icons.
• Fix Paragraph node button not working correctly.
• Fix node selection when hovering.
• Fix empty blocktype picker UI when no block types are available.
• Fix being able to copy/paste Vizy blocks into other fields (in a nested setup) that don’t support the same block types.
• Fix a JS error when trying to drag blocks between nested Vizy fields.
• Fix copying field handles when editing field content not working.
• Fix an issue where field layout fields may not be saved when adding quickly.
• Fix some HTML characters being stripped incorrectly due to LitEmoji processing.
• Fix node attributes like classes not always merging correctly with template-defined and config-defined.
• Fix nodes saving attributes with null values.
• Fix Paragraph empty checks when containing nested nodes/marks.
• Fix node serialization not working for nested nodes.
• Fix an error when invalid nodes were used (crashes editor).
• Fix some special HTML characters being stripped out of content.
• Fix accessibility for button modals.
• Fix menu bar items in dropdowns not showing their active state.
• Fix dropcursor glitches between Vizy blocks, and improve style.
• Fix an issue where saving Vizy fields inside Vizy Block field type settings weren’t always saved.
• Fix Redactor changes in Vizy blocks not having their content serialized correctly.
• Fix Table fields used in Vizy Blocks not saving correctly when rows in the table are deleted.
• Fix height of menu button options and scrollable container.

2.0.12 2023-02-27

Fixed

• Fix an error when querying Vizy blocks with GraphQL.

2.0.11 2023-02-21

Added

• Add support for Preparse plugin.
• Add content service to handle updating Vizy field content (mostly for Hyper (opens new window).
• Add $_type and $_field to Block. (thanks @leevigraham).
• Add the ability to set the initial number of rows for a field, to control its initial height.

Changed

• Change Vizy field data to be stored in vizyData to prevent collisions with inner fields (which are not needed but can override Vizy serialized content).
• Only admins are now allowed to access plugin settings.
• text for nodes is now automatically run through the raw Twig filter to decode HTML special characters.

Fixed

• Fix a GraphQL type error for VizyBlocks.
• Fix node types not appearing in the Explorer or Introspection for GraphQL.

2.0.10 2022-12-25

Changed

• Link marks now automatically parse for reference tags in their href.

Fixed

• Fix GraphQL queries throwing an error when fields aren’t initialized fully.
• Fix heading styles in editor.
• Fix an error importing via Feed Me, in some cases.

2.0.9 2022-11-09

Fixed

• Fix Feed Me importing not supporting all node types (just plain text).
• Fix an error where field settings for a block’s field layout can be corrupted.

2.0.8 2022-10-23

Fixed

• Fix handling of Vizy fields inside element slideouts, instead of block relationship fields when being edited.

2.0.7 2022-09-25

Added

• Add support for entries conditions for Vizy fields.

Changed

• Switch deprecated ueberdosis/html-to-prosemirror package to ueberdosis/tiptap-php.

Fixed

• Fix Vizy blocks not being site-aware.
• Fix “Open link in new tab” not saving correctly for link nodes.
• Fix asset fields within Matrix/Super Table fields not moving from the temporary upload directory.
• Fix an error when propagating element fields’s content for un-translated Vizy/SuperTable/Inner fields.
• Fix an error when propagating Super Table rows for un-translated Vizy/SuperTable/Inner fields.
• Fix an error when propagating Matrix blocks for un-translated Vizy/Matrix/Inner fields.
• Fix importing nodes via Feed Me not working for some node types.

2.0.6 2022-08-11

Fixed

• Fix Vizy node content being reset when inserting other nodes directly before it.
• Fix a field alignment issue in nested Vizy fields.
• Fix Vizy fields not initializing when switching entry types.
• Fix fields not working correctly in element slideouts, in some instances.

2.0.5 2022-08-09

Fixed

• Fix GraphQL queries throwing an error when fields aren’t initialized fully.
• Fix blocktype picker not appearing in Live Preview.
• Fix potential error for blocktypes.
• Update Vizy loading for input to handle proper loading using Vite.

2.0.4 2022-07-06

Fixed

• Fix an error when making GraphQL queries.

2.0.3 2022-07-02

Added

• Add vite-plugin-compression to generate gzipped JS/CSS assets.
• Add better handling for JS scripts on-load, to prevent against missing JS execution in some cases. (thanks @khalwat).

Changed

• Update CP template content block.

Fixed

• Fix a GQL deprecation notice.
• Fix HMR not working when making changes to vizy.js.
• Fix updating Block Type template not working correctly.
• Fix en error when trying to limit “Available Volumes” or “Available Transforms”.
• Fix an error when rendering an entry revision for nested Vizy fields.

2.0.2 2022-06-04

Fixed

• Fix an error with JS translations.
• Fix return types for node.renderHtml().

2.0.1 2022-05-28

Added

• Add changes/improvements from 1.0.14.

Fixed

• Fix renderHtml() not rendering HTML correctly.
• Fix JS initialization for input and settings.
• Fix field settings not initializing in some cases.

2.0.0 2022-05-05

Added

• Add checks for registering events for performance.

Changed

• Now requires PHP 8.0.2+.
• Now requires Craft 4.0.0+.
• Merge updates with version 1.0.13.
• Migrate to Vite and Vue 3 for performance.
• Rename base plugin methods.
• Replace deprecated Craft.postActionRequest() for JS.
• Improve field performance when editing in the control panel.

Fixed

• Fix Craft 4.0.0 compatibilities.
• Fix link sources having duplicate sources.
• Fix a type error when trying to render empty HTML.
• Fix Vizy field settings not picking up field layout changes when edited.

Removed

• Remove cleanDeltas(), which is no longer needed in Craft 4.