Changelog

2.3.7 2026-05-10

Fixed

  • Fix an error with applyUriCriteria.
  • Fix an issue with plugin migration and project config.

2.3.6 2026-04-29

Fixed

  • Fix Assets and other element link types and their no-URL check.

2.3.5 2026-04-16

Added

  • Add Link::customLinkText.

Fixed

  • Fix element selectors hiding valid targets when “Allow elements without URIs” was off for link types that do not use site uri the same way as routable entries (Asset, Calendar Event, Formie Form, User, Commerce Variant).

2.3.4 2026-04-11

Changed

  • Remove ElementLink::checkElementUri() in favour of proper link type setting.

Fixed

  • Fix handling for element field sources with plugin migrations in some instances.

2.3.3 2026-03-15

Changed

  • Refactor Hyper field bootstrapping to DOM auto-mount.

Fixed

  • Fix LinkCollection first-link getters for empty values.
  • Fix duplicate Hyper field initialization race.
  • Fix a race condition when changing link type where block data wasn’t updating.
  • Fix an error for some field migrations in some setups when run from the command line.
  • Fix an error for CKEditor 5+ and other plugins using registerScriptWithVars().
  • Fix an edge case of linkValue sometimes being an array and not normalized correctly.

2.3.2 2026-03-03

Added

  • Add ElementLink::modifyElementQuery to allow element link types to modify the query to resolve the element.

Changed

  • Entry element link types now (by default) no longer return disabled entries, only entries that are considered “live”.

2.3.1 2026-02-07

Added

  • Add support for Craft Content Block fields within links.

2.3.0 2026-01-25

Changed

  • Revamp link type field rendering to use DOM portals, rather than within Vue directly.

2.2.12 2026-01-23

Fixed

  • Fix initialization of Hyper fields with Vue, in certain circumstances.

2.2.11 2026-01-13

Fixed

  • Fix an error where Lightswitch fields with a default value were not being treated correctly.

2.2.10 2025-11-06

Changed

  • Improve element-caching to exclude drafts and revisions.
  • Improve change-detection checks for fields.

Fixed

  • Fix element cache not clearing cached linked-to elements when removing them from the field.

2.2.9 2025-09-16

Changed

  • Update migration-mode check.

Fixed

  • Fix an error for Site link type fields.

2.2.8 2025-09-02

Fixed

  • Fix an issue when propagating Hyper field values within Matrix fields on multi-site installs.
  • Fix craft.hyper.getRelatedElements not working correctly.
  • Fix an error when calling craft.hyper.getRelatedElements without a site param.
  • Fix an issue with Craft 5.8+ and cardThumbAlignment.

2.2.7 2025-07-18

Added

  • Add support for Hyper fields to be shown in element indexes and element cards.

Changed

  • Update English translations.

Fixed

  • Fix link type 25% and 75% widths.
  • Fix an issue with Craft 5.8+ and cardThumbAlignment.
  • Fix extra-small lightswitch style.
  • Fix an issue when switching link types for some fields (dropdowns).
  • Fix JSON normalization for arrayable data.

2.2.6 2025-05-14

Changed

  • Update Typed Link migration for Super Table and Matrix fields.

Fixed

  • Fix debug code generating a text.txt file in @webroot.

2.2.5 2025-05-01

Added

  • Add placeholder to list of sites for Site link types.

Changed

  • Update ArrayHelper::flatten.

Fixed

  • Fix multi-site Hyper fields not propagating element link types correctly.
  • Fix an error when changing field layout fields in Craft 5.7+.
  • Fix lightswitch UI for Craft 5.7+.
  • Fix querying custom fields on a link type with GraphQL.
  • Fix field changes being triggered for element-based links.
  • Fix an error when migrating content for prefixed databases.

2.2.4 2025-03-05

Fixed

  • Fix an error when embedding URLs with special characters.
  • Fix an error where international phone numbers were being stripped due to JSON normalization.

2.2.3 2025-02-02

Fixed

  • Fix GraphQL link type definitions for custom link types.
  • Fix link block spacing in element slide-outs.

2.2.2 2024-12-27

Fixed

  • Fix GraphQL LinkType using the translated link type label.
  • Fix a migration error for other link fields when renaming field instance handles.
  • Fix Db::prepareForJsonColumn deprecation and handling.
  • Fix content migration for some link plugins (LinkIt) for certain versions.
  • Fix field change warnings for Custom or URL link types.

2.2.1 2024-12-02

Added

  • Add LinkInterface::customAttributes for GraphQL queries.
  • Element links now have a “Show Site Menu” setting for multi-sites.

Fixed

  • Fix an error with Typed Link migration.
  • Fix “copy field handle” button style issue.
  • Fix field changes being triggered for element-based links.

2.2.0 2024-11-16

Added

2.1.2 2024-10-20

Added

  • Add support for Solspace Calendar Event links.

Changed

  • Custom Attributes can now override all default link attributes.

Fixed

  • Fix Hyper element links not being propagated correctly when adding new sites.
  • Fix rel attribute not working correctly.
  • Fix toggling “New Window” not persisting.

2.1.1 2024-10-10

Fixed

  • Fix en error with element links in Craft 5.4.7+.

2.1.0 2024-10-09

Added

  • Add a more descriptive warning when Hyper is initialized before Craft is.
  • Link types now can specify any required plugins via getRequiredPlugins().
  • Add the ability to merge identical Hyper fields via fields/merge and fields/auto-merge.
  • Add support for ElementEditor.js serialization event (introduced in Craft 5.5) to improve change detection of Hyper field content.

Changed

  • Improve handling of link types that are invalid (removed or unavailable).
  • Hyper will now throw a fatal error if an element query is made before Craft is initialized (as per Craft best practices).

Fixed

  • Fix en error with element links in Craft 5.4.7+.

2.0.5 2024-09-07

Added

  • Add extra error logging for Matrix and Super Table fields for Typed Link field migration.
  • Add “safe” attributes for various link properties to allow setAttributes correctly.
  • Add linkUri to the GraphQL LinkInterface class.

Fixed

  • Fix use of initialSerializedValue changes that were meant to address draft change behaviour.
  • Fix some properties of a link block being serialized when they don’t need to be.

2.0.4 2024-08-11

Fixed

  • Fix compatibility with Vizy.

2.0.3 2024-07-21

Added

  • Add Link::linkUri.

Changed

  • Change element-based links properly checking if their linked-to element is “empty”. For example, linking to a disabled element will now make isEmpty return true.

Fixed

  • Fix an error for multi-site installs where element links were being incorrectly propagated.
  • Fix element links not having their linkSiteId value reset when removing a linked element.

2.0.2 2024-06-15

Added

  • Add Link::lowerDisplayName.

Changed

  • Change Link::lowerDisplayName to Link::lowerClassDisplayName.
  • Change Link::displayNameSlug to Link::classDisplayNameSlug.

Fixed

  • Fix an error where min/max links are validated for non-multi link fields.
  • Fix an error for not handling invalid link content correctly.
  • Fix some JS not initializing for some fields when switching link types.
  • Fix an error for Feed Me.

2.0.1 2024-05-31

Changed

  • Update non-English translations.
  • Update English translations.
  • Update French translations. (thanks @pascalminator).
  • Update German translations. (thanks @MoritzLost).
  • Improve instructions text contrast for sub-fields.

Fixed

  • Fix link text returning a value when an invalid link.
  • Fix an error when determining the link text automatically when the linkText field is excluded from the link type.
  • Fix link type placeholder not being able to be overwritten.
  • Fix Link Type labels not being translated.
  • Fix link type translations.
  • Fix incompatibility issues with Matrix fields
  • Fix multi-link Hyper fields showing the incorrect “more” button for a single tab link type
  • Fix link type slide-out button not working correctly

2.0.0 2024-05-17

Added

  • Add Link::getLinkType() to return the LinkInterface for the link’s type.
  • Add Formie forms as a link type.

Changed

  • Now requires PHP 8.2.0+.
  • Now requires Craft 5.0.0+.
  • New element-based links on a multi-site now propagate the linked-to element for the same owner site.

Fixed

  • Fix an error where custom text set on a link is retained next time the same link is rendered (without custom text).
  • Fix an error with custom fields retaining values after initial creation.
  • Fix link type dropdown styling on Safari.
  • Fix field changes being triggered when no changes had been made.

Removed

  • Remove migrations for other plugin (not supported in Craft 5).