# April 26 Release (v21)

Wave Embedded v21 is here, and it is all about working smarter, not harder. This release delivers powerful enhancements and squashes bugs, all driven by one goal: making your everyday experience faster, smoother, and more intuitive.

Whether you are updating records in bulk, publishing grids, filtering data, or simply navigating your workspace, v21 makes every interaction feel more natural. Read on to see everything that is new.

*Version 21 also includes updates from v21.1, v21.2 and v21.3.*

***

## <mark style="color:purple;">New Enhancements</mark> ✨&#x20;

### Enhanced Filter Collection & Limit

[Filter Collections](/valorx-wave/wave-data-management/managing-grid-data/filter.md#filter-collection) now support richer admin controls and smarter runtime switching behavior, giving administrators fine-grained control over how filters are presented to end users.

**Switch Filter Collection Button logic**:

* Appears when Allow editing is **checked** AND **more than one Filter Collection exists**.
* Primary action opens/applies filters; secondary dropdown lists available Filter Collections.
* In read-only mode a switch icon/dropdown replaces the split button when multiple collections exist.

<figure><img src="/files/Oe3h3fVm5BTOZnWvix8X" alt=""><figcaption><p>Switch Filter Collection button logic</p></figcaption></figure>

**Switch Filter Collection details**:

* Selecting a collection **applies filters instantly** and refreshes the grid — no Save/Apply required.
* A **search bar appears** in the collection picker only when **more than 5 collections** are available.
* Tooltips ("Switch Filter Collection") appear on the caret in split-button mode, or on the switch icon in read-only mode.

<figure><img src="/files/n5O8oKAtjlXGaysfX78D" alt=""><figcaption></figcaption></figure>

**Limit:**

* A new limit of 20 Filter Collections per grid has been introduced, encouraging well-organized filter management and keeping the picker performant and easy to navigate.

### Color Palette for Greater Visual Control

We have expanded the color palette to a full spectrum, giving you far more freedom to visually organize and highlight your data, inspired by the rich color experience of Excel.

**The expanded palette is now available across:**

* [Column Group](/valorx-wave/wave-data-management/managing-grid-data/column-group.md)<br>

  <figure><img src="/files/s802aphsJGOIgLnk8EZ5" alt=""><figcaption><p>Color Palette - Column Group</p></figcaption></figure>
* [Rules ](/valorx-wave/wave-data-management/managing-grid-data/rule.md)<br>

  <figure><img src="/files/vf1rXVnOdmiZEj55OnIg" alt=""><figcaption><p>Color Palette - Rule</p></figcaption></figure>
* [Color Bar](/valorx-wave/wave-data-management/managing-grid-data/condition.md#color-bar)<br>

  <figure><img src="/files/NjbZL5mVbYzlrPDHcWEZ" alt=""><figcaption><p>Color Palette - Color Bar</p></figcaption></figure>

### Smarter, More Powerful Lookup Experience

We have upgraded the [Lookup](/valorx-wave/wave-data-management/data-control-and-customization.md#lookup) dialog with three meaningful improvements that reduce clicks, improve search accuracy, and remember your preferences across sessions.

**What is new:**

* **Expand by Default & Session Persistence**\
  Set your preferred lookup view once either **expanded or compact**, and it stays that way. Your selection is remembered per lookup object across all grids, so there’s no need to adjust it every time.
* **Cross-column search** - search across all displayed columns at once. Looking for a product? Type part of the product code or the product name and the lookup finds it either way.

<figure><img src="/files/zVv6hoAizIA4a0lHX85F" alt=""><figcaption><p>Powerful Lookup</p></figcaption></figure>

Together, these improvements make the lookup experience feel less like a search task and more like a seamless part of your workflow.

### Row-Level Selection for Mass Modifier

Users can now select one or more rows to apply [Mass Modifier](/valorx-wave/wave-data-management/managing-grid-data/mass-modifier.md) updates, removing the need to manually select individual columns or adjust the grid layout.

**How it works**

* Select rows using the row number
* Open [Mass Modifier](/valorx-wave/wave-data-management/managing-grid-data/mass-modifier.md) to apply updates across the selected rows
* Changes are applied to applicable editable fields in a single action

This is a major time-saver for teams who regularly update large datasets or work with grids that have many non-adjacent fields.

<figure><img src="/files/inQA6ggnyGOGppGa33gh" alt=""><figcaption></figcaption></figure>

### Flexible Footer Totals Configuration

A new [**Aggregation Footer**](/valorx-wave/wave-data-management/data-insights-and-summary.md#footer-row) checkbox in [Field Configuration](/valorx-wave/wave-experience/create-a-new-grid/grid-wizard-in-salesforce.md#field-configuration) lets Admins and Designers decide, column by column, whether a numeric field should display its aggregated value in the grid footer. It is a simple change that makes grids much cleaner and more focused.

**What you need to know:**

* Works for number, currency, and numeric formula&#x20;
* Checked by default for all new grids, so nothing changes unless you want it&#x20;
* Check it on to show the column sum in the footer, or off to hide it&#x20;
* The new checkbox sits between Hidden and Read Only in the [Field Configuration](/valorx-wave/wave-experience/create-a-new-grid/grid-wizard-in-salesforce.md#field-configuration)&#x20;
* Users can still change the aggregation type such as sum or average at runtime with no admin step needed.

<figure><img src="/files/BDue03FQcK6TpNRUSI3N" alt=""><figcaption><p>Aggregation Footer</p></figcaption></figure>

Backward compatibility is fully maintained. All grids created before this release will have the Total toggle enabled automatically, so your existing layouts remain unchanged.

### Streamlined Grid & Matrix Publishing Experience

We have redesigned the [publishing experience](https://docs.valorx.com/valorx-wave/release-notes/wave-embedded/pages/fm4j3cA2o5DevaNZvP0i#id-5.-publish-instruction) with a cleaner overlay, smarter status indicators, and built-in step-by-step instructions so you always know exactly where your grid is published and how to publish it.

Key changes in this release:

* **New status badge** - a clear Published or Not Published badge now appears in the grid info bar, so you can see publish status at a glance without digging into settings.
* **Publish Instructions tab** - a brand-new tab inside the publish overlay walks you through how to embed your grid on an App Page, Record Page, or Home Page in Salesforce.
* **Smarter overlay behavior** - for published grids, clicking Publish opens on the Locations tab. For unpublished grids, clicking Ready to Publish takes you straight to Instructions. One icon, always the right starting point.
* **Cleaner UI** - the Description column has been removed from Published Locations, reducing clutter and keeping the focus on what matters.
* **Matrix support** - the same publishing experience applies to Matrix with all labels correctly adapted.

<figure><img src="/files/rnBvnwT9Kbb4n0XBbbHn" alt=""><figcaption><p>Publish Location</p></figcaption></figure>

The dashboard publish experience has also been updated to match the Surf the Wave implementation, bringing consistency across your entire publishing workflow.

### Picklist Selection with Built-in Search

We have added a search bar to picklist dropdowns across Wave Embedded, so you can type to filter and find the value you need instantly. No more scrolling through endless lists to find a single option.

Search is now available in these dropdowns:

* [**Mass Modifier**](/valorx-wave/wave-data-management/managing-grid-data/mass-modifier.md) — Value and date literal dropdowns (Filters)
* [**Filter**](/valorx-wave/wave-data-management/managing-grid-data/filter.md) **conditions** and **date literal dropdowns**
* **Header filters** — Condition and date literal dropdown
* [**Column Grouping**](/valorx-wave/wave-data-management/managing-grid-data/column-group.md) — Group By dropdown
* **New Grid creation** — Salesforce view selector
* **Grid runtime** — Picklist field selection when editing records
* **Settings** — Feedback topic dropdown
* **Dynamic Measures** and **Data Config (Matrix)**

<figure><img src="/files/HFsSX5vi3Qh7fAEXAcq3" alt=""><figcaption><p>Picklist with Built-in Search</p></figcaption></figure>

This change makes Wave Embedded feel much more responsive, especially for teams working with large Salesforce orgs and long picklist value lists.

***

## <mark style="color:purple;">Bug Fixes</mark> :bug:

We’ve resolved multiple issues to improve stability, permissions handling, and overall grid and matrix performance.

* **X-Axis Date Header Overflow in Matrix**\
  Fixed an issue where matrix X-axis dates extended beyond the record end date. The timeline now stops correctly at the final quarter.
* **Related List Loader Issue with Restricted Lookup Fields**\
  Fixed an infinite loading issue caused by restricted lookup fields. The system now skips inaccessible fields or shows a permission message.
* **Image Attachments Download Failure (CORS Error)**\
  Fixed a CORS issue preventing image downloads. Images now download successfully.
* **PDF Attachments Blocked in Chrome**\
  Fixed a browser blocking issue. PDF files now open and download without errors.
* **Lookup Expand Search Not Returning L2 Results**\
  Fixed an issue where L2 field searches returned no results. Search now works across all columns.
* **Restricted Fields Showing in Related List**\
  Fixed an issue where inaccessible fields appeared as locked. These fields are now hidden from users without permission.
* **Matrix Resize Issues (Headers & Totals Column)**\
  Fixed inconsistent X-header resizing and enabled resizing for the totals column.
* **Attachment Upload “Input Too Long” Error**\
  Fixed a file upload issue. Files within the allowed size now upload correctly.
* **Apex CPU Limit Error in Lookup Filter Job**\
  Fixed a processing issue where lookup filter jobs exceeded CPU limits.
* **“Grid Losted in Wave” Error**\
  Fixed an issue with Last Modified fields causing grid load failure.
* **Action Column Selection & Spacing Issues**\
  Fixed unintended row selection and corrected action button alignment.
* **Lookup Field Not Auto-Populating in Related List**\
  Fixed inconsistent auto-population of parent lookup fields when creating new records.
* **Matrix Rendering Only One Record on First Run**\
  Fixed an issue where only one selected record displayed initially. All records now load correctly.
* **Column Order Not Persisting in Column Groups**\
  Fixed an issue where column reordering was not saved. Order now persists after saving.
* **Numeric Input Issue (Decimal & Minus Sign)**\
  Fixed input behavior. Users can now enter decimal values directly (e.g., .908 → 0.908).
* **Dependent Picklist Not Refreshing on Save**\
  Fixed inconsistent refresh behavior. Picklists now update correctly across all flows.
* **Select All After Search Not Working**\
  Fixed an issue where only one record was selected after filtering. Select All now works as expected.

***

{% updates format="full" %}
{% update date="2026-05-15" %}

## Wave Embedded v21.3 - Hotfix

This hotfix release focuses on improving matrix view presentation, field-level security handling, smart import reliability, and lookup cell display consistency.

#### What's Improved

**Vertical Orientation Matrix Column Header** \
Removed the column header name that appeared in vertical orientation matrix views for a cleaner and more polished presentation.

<figure><img src="/files/lpyb9YCA7Uz4FysmfKTa" alt=""><figcaption><p>Matrix - Vertical Orientation</p></figcaption></figure>

**Suppressed "Salesforce Field Removed" Toast Notification** \
The "Salesforce fields removed" toast message is no longer displayed on grid load when a field is inaccessible due to FLS or deleted from Salesforce. The event is now logged to the console instead.

**Lookup ID Import via Smart Import** \
Fixed an issue where importing lookup IDs from Excel resulted in empty cells and an import failure. Lookup IDs now import correctly into Salesforce through Smart Import.

**Lookup Cell Text Wrapping** \
Fixed an issue where lookup chip text in grid and matrix cells did not wrap like standard text cells. Lookup chips now wrap correctly, showing an ellipsis only when the cell space is fully filled.

Thank you for your continued feedback. This hotfix ensures a smoother and more consistent experience with Wave Embedded.
{% endupdate %}

{% update date="2026-05-12" %}

## Wave Embedded v21.2 - Hotfix

This hotfix release focuses on restoring grid and matrix view functionality following the Salesforce Summer '26 Sandbox release update.

#### What's Improved

**Grid and Matrix View Loading After Salesforce Summer '26 Sandbox Update** \
Fixed an issue where grids and matrix views displayed a continuous loader with no data or UI components after the Salesforce Summer '26 Sandbox release update. All grid and matrix screens now load correctly with full data and UI components displayed as expected.

Thank you for your continued feedback. This hotfix ensures a stable and reliable experience with Wave Embedded following the Salesforce Summer '26 Sandbox upgrade.
{% endupdate %}
{% endupdates %}

{% updates format="full" %}
{% update date="2026-05-06" %}

## Wave Embedded v21.1 - Hotfix

This hotfix release focuses on improving stability and usability for lookup interactions in grids.

#### What’s Improved

**Lookup Picker Loading for Users Without View Setup Permission**\
Fixed an issue where users without View Setup permission experienced a continuous loader when opening a lookup picker. Lookup records now load correctly in both collapsed and expanded states, even without View Setup access.

Thank you for your continued feedback. This hotfix ensures a smoother and more reliable experience with Wave Embedded.
{% endupdate %}
{% endupdates %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.valorx.com/valorx-wave/release-notes/wave-embedded/embedded-version-21.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
