1.0.x

Use Meta Box custom fields as dynamic data throughout Mosaic, covering post, term, user, and settings page meta, custom post types, and the full range of Meta Box field types from text and media to groups and references.

Read MB Relationships connections as dynamic data, so a template can list the posts, terms, or users connected to the current object in either direction.

Frontend form strings like validation and success messages are now translatable, so forms can be localized to your visitors’ language using standard WordPress translation files.

Connected objects in reference loops are now loaded in bulk instead of one by one, and oEmbed URLs are cached, removing repeated database and external requests when Meta Box fields render in loops.

Form actions now have their own icons in the editor, making them easier to tell apart when a form has several actions configured.

The Add panel now closes after you insert an element. Keeping it open while placing elements one after another turned out to slow building down in practice, so insertion returns to the previous behavior.

Fixed timed scroll into view interactions that could never reach their fully visible state on some screens, leaving the animation unplayed.

Fixed entry button styles defined in the Gutenberg styles editor not being applied inside the block editor, while working correctly on the frontend.

Fixed cloned Google Maps elements in the editor rendering the original element’s data instead of their own, for example inside loops.

Fixed nested loop variables not resolving when the outer level had no data, which hid Value and Label variables and could break the dynamic data modal for empty repeaters and groups.

Fixed the Exit to WordPress button in the Gutenberg styles editor navigating back into the editor instead of leaving it.

Added a Google Maps element. Enter an address or place name to drop a pinned map, with zoom and map type controls, and dynamic data support for both the address and zoom level.

Forms can now send submitted data to an external URL on submit, with a configurable method, headers, and JSON or form-encoded payload, connecting Mosaic forms to automation and CRM tools.

Forms can now subscribe submitters to a Mailchimp audience, with list selection, merge field mapping, tags, and configurable opt-in status.

Forms can now subscribe submitters to MailerLite, with group selection, field mapping, and configurable opt-in status.

Added a search field to the add panel that searches across elements, components, and library items at once.

Added a preview button to library items in the add panel, opening a live render of the item in a new tab before inserting it.

Added a new Site variable for the WordPress Administration Email Address, so it can be used directly in form actions such as the “To” field of an email action.

Added a Rel setting to link and popover link-action configuration, letting authors control attributes such as noopener, noreferrer, and nofollow on rendered links.

Reworked the editor exit button into a dropdown with direct options for WordPress, Frontend, and the page or post being edited, using native links that support opening in a new tab.

The add panel now stays open after inserting an element, so multiple elements can be added in a row without reopening the panel each time.

Component instances in the Navigator now show the source component’s name (e.g. “Instance – Logo”) instead of a generic “Instance” label, making structure easier to read at a glance.

Restored proper datetime filtering for Post and User sources with a dedicated date comparator, supporting before/after comparisons against dates, timestamps, and dynamic values.

Added HTML-output variables for form file fields, rendering a single upload as a clickable link or multiple uploads as a list of links in email notifications.

Unified the layout, field widths, and visual style across all form element settings panels for a more consistent editing experience.

Deleting the active element now moves focus to a surviving sibling or parent instead of clearing selection, keeping form success screens, dropdowns, and similar containers visible without the preview jumping.

Fixed theme export failing with a “Manager is missing” error when a theme contained deleted nodes, and fixed a separate memory exhaustion crash on large themes.

Fixed a fatal error when importing a theme exported from an older version, caused by a naming collision in the internal upgrade process.

Fixed the page becoming completely unresponsive when a looping interaction animation targeted an element that wasn’t present on the current page.

Fixed saving a custom font collection variable failing with a server error when the font faces field contained a standard @font-face rule.

Fixed an editor crash when a component instance contained a nested loop, which also prevented lists, accordions, tabs, sliders, and form steps from crashing in the same way.

Fixed switching a condition’s comparator type silently corrupting the stored operator and value on save, which could cause conditions to evaluate incorrectly.

Fixed a multi select field being impossible to submit when its default disabled placeholder option was left selected.

Fixed the “All fields” output rendering incorrectly for checkbox and radio fields, and corrected the settings label from “Options” to “Choices” for checkboxes and radios.

Fixed custom attributes not being applied when added without a value.

Fixed the Navbar’s “Disable body scroll” option resetting scroll position (jumping sticky navbars to the top) and reserving an oversized scrollbar gutter when the menu opened.

Fixed several keyboard shortcuts not working correctly on Mac due to conflicts with reserved browser shortcuts.

Fixed the mouse back and forward buttons not navigating within the editor.

Fixed the add panel not refreshing to show scope-specific elements after inserting an element with its own interaction scope.

Various small fixes and internal improvements.

Build fully customized forms visually in Mosaic, from simple contact forms to advanced interactive layouts with flexible fields, actions, states, and styling controls.

Added visitor variables to dynamic code, including IP address, user agent, referrer, and current page URL for more contextual output.

Added support for ordering queries by ACF custom fields, with proper meta value casting for more accurate sorting by numbers, dates, and other value types.

Expanded the condition system with built-in string, date, and number comparisons for more precise visibility and logic rules.

Fixed an issue where transform settings could not be saved correctly when configuring interaction animations.

Embed Vimeo videos with support for normal, unlisted (privacy hash), and player URLs. Includes autoplay, mute, controls, start time, privacy (DNT) mode, lazy loading, and scroll-based playback via IntersectionObserver.

Added responsive page count controls for loop pagination, including pages before and after the current page, plus pages shown from the start and end.

Link search now includes non-public posts and pages, with status indicators for draft, private, scheduled and password-protected content.

Added support for the ACF Group, Flexible Content, and Clone fields, including their nested sub-fields, so their values can now be accessed and used as dynamic data in your designs.

New font families no longer prefill with “Inter”, so clicking the field lists every available font right away instead of appearing limited to two options.

Fixed duplicated loop item elements rendering inconsistently across editor, preview and frontend when multiple items use Item mode in the same parent.

Player Play, Pause and Seek interaction actions now control the YouTube element, matching the behavior already available on the Video and Vimeo elements.

Theme import via the wizard no longer leaves empty temporary folders behind. Wizard files are now grouped into a dedicated subfolder and removed properly after the import finishes.

Fixed an issue where reactivating the plugin could create duplicate entries for the same site in the Active sites list on account.mosaicbuilder.com.

Fixed custom states popup submission with Enter key, so values are now stored correctly and the popup behaves the same as clicking the Add button.

Fixed font-family variable generation for font names containing spaces by wrapping custom font names in quotes to ensure valid CSS output and proper font loading.

Fixed an issue where multiple meta viewport tags could be rendered in the document, causing invalid markup and inconsistent browser behavior.

Fixed Current within state detection for WP Menu dropdown toggles, so parent menu items are styled correctly when a submenu page is active.

Fixed taxonomy exclude filters causing database errors when posts have multiple excluded terms, including support for custom database prefixes.

Fixed input and select fields appearing taller in WordPress 7.0 by resetting inherited min-height styles from core WordPress CSS.

Help Center buttons no longer pick up WordPress admin link colors on focus, keep their correct styling, and stay aligned even when label text differs in length or wraps to multiple lines.

Mosaic no longer leaks its frontend styles into the WordPress admin area when using the block editor, so they can’t bleed into or break the wp-admin interface.

Fixed an incompatibility with the Nexter Extension Image Optimizer plugin. When its WebP conversion and auto-optimization stored images outside the standard WordPress uploads folder, Mosaic failed to resolve the attachment URLs and images wouldn’t load in the editor or frontend. Optimized images now resolve and display correctly.

Added support for ACF image arrays and Link fields, along with improved handling of fields returning multiple formats like URL and attachment ID, enabling a single field to expose multiple variables in Mosaic. Updated structure for repeater and nested loop fields to better reflect data hierarchy.

Breaking change affecting specific cases only; most existing ACF variables will continue to work. If a variable no longer renders, replace it with the new format in the editor.

Added keyboard navigation support for UI lists in the editor, allowing users to move through items and make selections using arrow keys and shortcuts for faster, more accessible workflows.

Added new variables for current user data, including logged in state, role, capabilities, fields, and user meta for more dynamic and personalized content rendering.

Added Alt Text variable to Media dynamic source, returning the WordPress Alternative Text value or an empty string when not set.

Dropdown and hamburger menus now automatically close when navigating via anchor links, ensuring a smoother user experience and preventing menus from staying open after section jumps.

Navigate search now shows more matching results than before, making it easier to find pages, templates, and other items directly from the search view.

Updated Navigator naming for Div, Section, and Text elements so the defined tag name is shown when no custom element name is set.

Added compatibility for popular optimization plugins to prevent critical Mosaic scripts from being deferred or delayed. Includes manual option for Cloudflare Rocket Loader via wp-config setting.

Hardened security across actions and preview flows by restricting returned data for lower user roles, replacing raw exception output with safe messages, and validating wizard preview JSON input more strictly.

If the Alt field is empty, image elements now automatically render an alt attribute on the frontend when the source is an attachment URL or a dynamic value returning an attachment ID.

Fixed missing variable handling when a site has no pages or posts, preventing errors and ensuring the builder works correctly on empty WordPress installations.

Fixed issue where the ellipsis state in Loop Pagination Number could not be styled, allowing consistent design control across all pagination elements.

Fixed issue where the template assign window did not open after using quick post edit, so template assignment works correctly without needing a full page reload.

Fixed SVG handling in theme export and import when WordPress SVG upload support is enabled through an attachments plugin, ensuring SVG assets are transferred correctly.

Fixed issue with interaction-related scripts when inline script loading was enabled, ensuring proper execution and preventing missing or broken interactions.

Fixed fatal error when opening a taxonomy archive template editor for a taxonomy with no records, ensuring the correct term context is used instead of falling back to a post.

Fixed an issue where an element caused the frontend render to fail, preventing proper page rendering.

Fixed multiple issues with wrap in link logic, including missing restrictions on loop items, lack of nested link checks, and missing placement validation to prevent invalid structures.

Fixed precision issue in the interaction observer where floating point rounding caused scroll into view triggers to fail when thresholds contained high decimal values.

Fixed issue where pasting into a style declaration could unintentionally overwrite Text element content, ensuring pasted CSS only affects the intended field.

Fixed invalid default structure in WP Menu element where dropdown content was placed inside a link, preventing nested link issues and ensuring correct element hierarchy.

Added missing featured image variables for Front Page and Index paths, ensuring consistent variable availability alongside title and content.

Fixed issue where using browser back navigation inside the wizard preview frame caused unintended page navigation, ensuring the preview remains isolated and stable.

Added aria-label to the mobile navigation toggle icon to improve accessibility and screen reader support on smaller devices.

Fixed an issue where the WordPress menu element was not rendered as a proper list, ensuring correct HTML structure and improved compatibility with themes and accessibility tools.

Removed the “Beta” tag from the Mosaic logo to reflect its stable release status and ensure consistent branding across the interface and assets.

Streamlined onboarding and theme creation with Pagekits, plus a redesigned setup wizard for a smoother and more guided customization flow.

Added new variable types for Background & Gradient, Box Shadow, and Text Shadow. Introduced nested variables and usage controls at collection, group, and variable levels. Font size and line height now support variables.

Introduced a new List element with four element classes: Vertical, Horizontal (unstyled semantic lists), Ordered, and Unordered. Supports Loop items, allowing dynamic records to be rendered directly inside the list.

Replaced the editor in Code and Shortcode elements with CodeMirror 6, providing modern syntax highlighting and improved editing experience with full dynamic data support.

If no navigator dock preference is stored in the browser, the Navigator will now start undocked when the editor loads on screens below 1600px width.

Added support for a wide range of ACF field types, including basic fields, media, choices, relational fields, maps, date/time pickers, icon/color pickers, and repeater.

Expanded the interaction system with new interaction types for Slider, Tabs, Dropdown, and Accordion elements based on their state changes.

Added a delay option to the Pageload interaction type, allowing actions to be triggered after a defined time interval once the page has loaded.

Added new dynamic data functions: @ESC_ATTR, @ESC_HTML, and @JSON_ENCODE. Renamed existing functions for consistency and clarity (e.g. @FINDIMAGE → @FIND_IMAGE, @ROUNDUP → @ROUND_UP, @JSONENCODE → @JSON_ENCODE).

Enhanced error reporting when required server modules or systems are missing. Clearer messages are shown for outdated PHP versions, missing extensions (zip, gd, dom, curl), or unsupported database engines (only MySQL and MariaDB are supported).

Style Guides are now called External Styles. Introduced Gutenberg Styles, which include popular Gutenberg blocks and allow site-wide control of typography, spacing, and colors for consistent design.

Introduced a redesigned Condition UI with improved structure and usability, making it easier to create, manage, and understand complex visibility and logic conditions.

Accordion now uses semantic definition list markup for better structure and accessibility. Added an option to keep all items opened by default, allowing fully expanded display without toggle behavior.

Added new Hide in Editor and Show in Editor actions for elements, allowing precise control over element visibility within the editor without affecting frontend output.

Added an offset option to the Scroll Direction Change interaction. You can define a pixel value that must be scrolled before the direction change is triggered. Default value is 0, preserving the original behavior.

Improved semantic structure in the Theme Library to provide better, more meaningful markup as a starting point for new projects.

Reduced excessively long internal plugin file paths to ensure compatibility with Windows environments that enforce the 260-character maximum path length limitation.

Fixed frontend breakpoint style ordering so Base no longer overrides “Up” breakpoints and “Up” breakpoints cascade from smallest to largest. New order: base → smallest up → largest up → largest down → smallest down → custom.

Fixed the Div element’s dynamic source offset setting not applying user input. The offset value now correctly updates and affects the rendered results instead of always staying at 0.

Fixed an issue where the “Insert loop” button inside a nested Loop received an inactive class, causing incorrect styling. The button now displays and functions correctly when adding a Loop inside another Loop.