Gravity Forms Dynamic Lookup Changelog

This release adds a developer API that lets other GravityKit products (like Advanced Filter's enhanced filter picker) search, paginate, and count Lookup field choices on demand, and hardens output escaping for the Lookup field's displayed value.

🔒 Security

• A Lookup field's displayed value was not escaped on output, so certain content from the source form could render incorrectly.

🐛 Fixed

• Post Lookup choices ignored the configured sort order when the site had sticky posts, which were moved to the top of the list.
• The form editor's "maximum results" notice for user-based Lookup fields loaded every matching user ID into memory and could report a count that disagreed with the visible choices when ordering by post count.
• Searching Lookup choices from Advanced Filter's condition picker treated % and _ as wildcards for Gravity Forms sources.

💻 Developer Updates

• Added a choice API on Lookup fields for searchable, paginated, and counted choices: search_lookup_choices(), count_lookup_choices(), resolve_lookup_choices(), and get_lookup_display_selector(), used by GravityKit Query Filters' searchable choice picker. Counts honor the search term, and paginated results stay contiguous and duplicate-free.
• Added gk/lookup/choice-query/bypass-filter filter to control whether the choice API bypasses "Filter by Field".
• Added gk/lookup/choice-query/bypass-user-limit filter to allow capability-checked callers to resolve labels for entries created by other users.

🔧 Updated

• Foundation to version 1.25.0.

This release adds relational 'Filter by Field' lookups and searchable dropdown support to Dropdown Lookup fields, and resolves multiple issues with lookup choices serving stale results.

🚀 Added

• "Filter by Field" setting for Dropdown Lookup fields using the Gravity Forms source: choices narrow to entries whose selected source field matches the value entered in another field on the same form (for example, matching an email address between two forms).
• Support for Gravity Forms' "Enable enhanced user interface" setting on Dropdown Lookup fields: the choice list renders as a searchable dropdown, including while choices are being filtered.

🐛 Fixed

• Lookup choice lists could serve stale results:
  • Entries created or updated via the Gravity Forms API (REST API, imports, automations) did not appear until the cache expired, up to 24 hours later;
  • Empty choice lists were cached for up to 24 hours (now 5 minutes, and the form editor always shows current data);
  • Clearing the cache did not work on multisite and could keep serving stale results on sites using a persistent object cache.
• Lookup fields with "Show only entries created by current user" enabled did not always reflect the viewing user, so the available choices could be inaccurate.

💻 Developer Updates

• Added gk/lookup/filter/value filter to modify the value used to filter lookup choices.
• Added gk/lookup/filter/max-results filter to change the maximum number of filtered choices (default: 100).
• Added gk/lookup/filter/allow-public filter to disable filtered choice lookups for logged-out visitors.

🔧 Updated

• Foundation to version 1.24.2.

This release improves Lookup field rendering performance in Views.

✨ Improved

• Lookup fields no longer run duplicate database queries each time they render in a View.

🔧 Updated

• Foundation to version 1.21.0.

This update fixes display issues with Source of Choices cards in the form editor.

🐛 Fixed

• Source of Choices cards in the form editor:
  • Missing Gravity Forms icon;
  • Broken alignment on narrow screens.

🔧 Updated

• Foundation to version 1.11.0.

This release ensures Lookup fields show display values instead of raw IDs when using the {all_fields} merge tag.

✨ Improved

• Lookup fields now display their configured display value (e.g., user names, post titles) instead of raw IDs when used with the {all_fields} merge tag in confirmations and notifications.

🔧 Updated

• Foundation to version 1.8.0.

This release adds merge tag modifier support for Lookup fields, allowing access to any attribute from the referenced object (e.g., user email, post permalink, entry fields) across Gravity Forms and GravityView.

🚀 Added

• Merge tag modifiers for Lookup fields:
  • Access additional attributes beyond the configured Display Value using {Field Label:field_id:modifier} syntax (e.g., {Assigned User:2:user_email} for the user's email).
  • Supported in notifications, confirmations, and anywhere Gravity Forms merge tags are used.
• Lookup fields in GravityView Views now display readable values instead of raw IDs.

💻 Developer Updates

• Added gk/lookup/field/source-object filter to substitute a custom object (WPUser, WPPost, or entry array) when resolving lookup IDs.
• Added gk/lookup/field/display/value filter to transform attribute values before display.
• Added gk/lookup/field/display/separator filter to change the delimiter between multiple lookup values (default: ", ").
• Added gk/lookup/field/display/missing filter to customize what appears when a referenced object has been deleted (default: raw ID).
• Added gk/lookup/field/access/meta-key filter to allow access to protected meta keys (default: false for underscore-prefixed keys).
• Added gk/lookup/field/access/private-taxonomy filter to allow access to private taxonomies (default: false).

🔧 Updated

• Foundation to version 1.7.2.

This update adds configurable selection limits to Lookup fields that use the Multiple Choice input type.

🚀 Added

• Lookup fields using the Multiple Choice input type can now enforce selection limits, including single choice, unlimited choices, exact numbers, or min–max ranges.

🔧 Updated

• Foundation to version 1.7.0.

This update adds support for more Gravity Forms field types and WordPress content sources, and improves how lookup fields appear in GravityView’s Search Bar.

🚀 Added

• Support for Name, Address, Date, Time and Number fields.
• WordPress posts, pages and custom post types can now be used as lookup sources.

✨ Improved

• Lookup fields in GravityView’s Search Bar can now be displayed using different input types (Select, Multi-select, Radio, Checkbox or Links) instead of being limited to a text input.

This release makes Lookup fields available for use in conditional logic.

🚀 Added

• Support for using the Lookup field in conditional logic, both in Gravity Forms and in GravityKit products.

This hotfix prevents a fatal error when Gravity Forms is missing.

🐛 Fixed

• Fatal error on plugin activation if Gravity Forms is not installed and activated.

✨ Improved

• Changing the source of a Lookup field only gives a warning if the field has existing entries.
• Reduced the number of database queries when loading choices for sites without object caching.
• Changed the default storage format to "ID" to better take advantage of the dynamic nature of the field value: when the field is configured to use the ID as the value, the value will update dynamically when the source entry field is updated.
• When the storage format is "ID", the label will be displayed in the Entries table in Gravity Forms.

🐛 Fixed

• The "Lookup Field Settings" label was showing for all fields.

This update resolves caching issues and improves data source handling for better performance.

🐛 Fixed

• Gravity Forms entry cache was not clearing for new or modified entries, preventing new values from being visible.
• Prevented using the current form as a data source to avoid infinite loops.

🚀 Initial release!