> For the complete documentation index, see [llms.txt](https://docs.valorx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.valorx.com/valorx-wave/release-notes/wave-embedded/embedded-version-22.md).

# June 26 Release (v22)

Wave v22 introduces 360 Snap as its headline feature, bringing the full Salesforce record experience directly into the Wave Grid and Matrix Y-Axis view details, work across related lists, and edit records without ever leaving the grid. Alongside 360 Snap, this release delivers a wide range of enhancements across the Grid and Matrix to give users and designers more flexibility and control.

***

<h2 align="center"><mark style="color:purple;">Release Highlights</mark> <span data-gb-custom-inline data-tag="emoji" data-code="1f389">🎉</span></h2>

<h3 align="center"><mark style="color:$tint;"><strong>360 Snaps</strong></mark></h3>

How many times has your team had to open a separate tab, navigate away, or switch context just to get the full picture of a record? That's time lost and focus broken.

**360 Viewer ends that**. Now, every record in your Wave Grid is a single click away from showing you everything you need: the full record details, related lists, and the ability to make changes all within a clean, structured panel that sits right inside your grid.

**No tab switching. No navigation. No lost context.**

<figure><img src="/files/90oCT7Kb6kruWQ0NwdZB" alt=""><figcaption><p>360 View</p></figcaption></figure>

#### What is 360 Viewer?

[360 Snap](/valorx-wave/wave-admin-and-control/360-snap.md) gives every user in your organization a complete, contextual view of any Salesforce record directly inside the Wave Grid and Matrix. Click on a record or a related lookup field, and a [360 View](/valorx-wave/wave-admin-and-control/360-snap.md) panel opens instantly, showing:

* **The record's key details**&#x20;

  All the header fields you care about, laid out cleanly. No scrolling through a full Salesforce page.
* **All the related lists in one place**&#x20;

  See Opportunities, Cases, Contacts, or any related data organized in tabs on the left, with the full grid experience on the right.
* **Editable, right where you are**&#x20;

  Make changes to record fields or related list data without navigating away. Save with confidence using the same familiar Save Changes workflow.

<figure><img src="/files/7RqlM4EFUnaCTf4lhFm6" alt=""><figcaption><p>Edit the records using 360 View</p></figcaption></figure>

#### Why It Matters?

Your team works in the grid because it's fast, structured, and powerful. 360 Viewer extends that power so users never have to leave to get the context they need.

<table><thead><tr><th>Before 360 Viewer</th><th valign="top">With 360 Viewer</th></tr></thead><tbody><tr><td>Open a record → wait for Salesforce to load → find the related list → navigate back → lose your place in the grid.</td><td valign="top">Click once → see everything → edit what you need → save → stay in the grid.</td></tr></tbody></table>

<h3 align="center">Snap in Matrix</h3>

360 Viewer is also supported on the Matrix Y-Axis, bringing the same full record experience to your matrix grids.

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

Ready to set it up? See the [360 Snap Documentation](/valorx-wave/wave-admin-and-control/360-snap.md) for a full configuration guide.

<h3 align="center">Slim &#x26; Sleek Toolbar</h3>

The [**Toolbar**](/valorx-wave/wave-admin-and-control/enterprise-control.md#toolbar-1) has been redesigned to be slimmer and sleeker across both Grids and Matrices. Designers now have granular control over which toolbar items are visible at runtime and how they are displayed (icon only, or icon with label).&#x20;

<figure><img src="/files/Fv8IJf9ygD0BxR6nm546" alt=""><figcaption><p>Toolbar (Grid Controls)</p></figcaption></figure>

***

<h2 align="center"><mark style="color:purple;">Grid Updates</mark> <span data-gb-custom-inline data-tag="emoji" data-code="2728">✨</span></h2>

### Wave Grid Read-Only

A new [**Wave Grid Read-Only**](/valorx-wave/wave-admin-and-control/enterprise-control.md#access-options-1) setting is available under [Grid Controls](/valorx-wave/wave-admin-and-control/enterprise-control.md) in the Permissions tab. When enabled, the grid becomes fully read-only, allowing users to view records, select single or multiple rows, and run supported actions without the ability to edit grid data.

<figure><img src="/files/2RqjgPVSAPh1gJ9fikFC" alt=""><figcaption><p>Make Grid Read Only (Grid Controls)</p></figcaption></figure>

The following example shows the Grid Read-Only setting. The **All Contacts** grid allows users to make changes, whereas the **Latest Contact** grid is set to Grid Read-Only and cannot be edited.

<figure><img src="/files/T1wTWpuv3OcbspI6fAJA" alt=""><figcaption><p>Make Grid Read Only (Runtime)</p></figcaption></figure>

### Wave Dynamic Grid

Admins and Designers can configure a Wave Grid to render dynamically based on a JSON configuration stored on a parent record, allowing a single grid to adapt its columns, field access rules, and layout per record. Fields can be set as mandatory, read-only, or read/write. The field configuration also supports a `backgroundColor` property to define a background color per field.

Find out more about [Wave Dynamic Grid](/valorx-wave/surf-the-wave/publish-the-grid/dynamic-grid.md).

<figure><img src="/files/eYRm0JGsEyfV9xM5sTRE" alt=""><figcaption><p>Wave Dynamic Grid</p></figcaption></figure>

### Date and DateTime Support in Formula Fields

[Formula Fields](/valorx-wave/wave-data-management/data-control-and-customization.md#formula-field) now support [Date and DateTime](/valorx-wave/wave-data-management/data-control-and-customization.md#date-and-datetime-functions) as return types, in addition to the existing Number and Text types. A new set of date-specific functions is available, allowing Designers and Standard Users to create calculated date columns such as days until close, contract duration, or deadline status directly in the Wave grid.

#### What's New at a Glance

<table><thead><tr><th width="205" valign="top">Area</th><th valign="top">Detail</th></tr></thead><tbody><tr><td valign="top">New return types</td><td valign="top">Date, DateTime, added alongside String, Number, Boolean, Currency</td></tr><tr><td valign="top">now()</td><td valign="top">Returns the current date and time</td></tr><tr><td valign="top">dateDiff(d1, d2, unit)</td><td valign="top">Difference between two dates in days, weeks, months, or years</td></tr><tr><td valign="top">dateAdd(date, n, unit)</td><td valign="top">Adds or subtracts days, weeks, months, or years from a date</td></tr><tr><td valign="top">date(y, m, d)</td><td valign="top">Constructs a date from year, month, and day integers</td></tr><tr><td valign="top">year() / month() / day()</td><td valign="top">Extracts individual components from any date field</td></tr><tr><td valign="top">formatDate(date, fmt)</td><td valign="top">Returns a date as a formatted display string</td></tr></tbody></table>

<figure><img src="/files/B0ajeFRm1BewAmqH7M0R" alt=""><figcaption><p>Date Formula</p></figcaption></figure>

{% hint style="info" %}

#### Note

Time components are not supported when the output type is Date. Any DateTime input will have its time component discarded.
{% endhint %}

### Filter by Color — Rule Driven Visual State Filtering

Users can now filter grid rows by their Rule state directly from the Legend panel or a column header dropdown. When rules are applied to a grid, the [**Filter by Color**](/valorx-wave/wave-data-management/managing-grid-data/rule.md#filter-by-color) option lets users instantly isolate rows that match a specific rule such as rows highlighted in a particular color, marked as read-only, or flagged with a bar indicator without needing to set up manual field filters.

<figure><img src="/files/ODrd9wdxt2BRqyOhR21M" alt=""><figcaption><p>Rule filter by color</p></figcaption></figure>

### Valorx Grid and Matrix Support on LWR Sites

Valorx Grid and Matrix can be used on [Lightning Web Runtime (LWR)](/valorx-wave/surf-the-wave/publish-the-grid/lightning-web-runtime-lwr.md) sites. Before adding a Valorx Grid or Matrix component to an LWR site, Admins must update two Security & Privacy settings in Salesforce to ensure the components load correctly.

<figure><img src="/files/Rl5RMqTFo5usNJBzyuFL" alt=""><figcaption><p>Valorx Grid on Lightning Web Runtime (LWR) sites</p></figcaption></figure>

### Fiscal Year Support in Rules and Header Filters

Rules and Header Filters now support Standard and Custom Fiscal Year configurations from Salesforce. Fiscal Year and Quarter literals align with the fiscal settings defined in your Salesforce org, allowing rules and filters to evaluate data accurately against your organization's fiscal calendar. If fiscal settings are not configured, standard calendar behavior is maintained

<figure><img src="/files/aZ2NzgsYJzK9gqFiYmSX" alt=""><figcaption><p>Fiscal Year in Rule</p></figcaption></figure>

### Copy Link — Shareable Custom Grid Links

Users can now generate and share a secure link to a [Custom Grid](/valorx-wave/wave-experience/type-of-grid-in-wave.md#custom-grid-my-grids) directly from the [Share Grid](/valorx-wave/wave-experience/type-of-grid-in-wave.md#copy-link-custom-grid-sharing) dialog. The generated link can be copied and shared with peers, who can access the grid if they are in the same org. Links are secure and do not expose any internal identifiers. A link can be revoked at any time, immediately revoking access for all users it was shared with.

<figure><img src="/files/tRUGrJqJSJH4xqwigdfn" alt=""><figcaption><p>Copy Link</p></figcaption></figure>

### Input Records — Support for New Unsaved Records in Embedded

Input Records in the Embedded Grid now supports passing new records that do not yet have a Salesforce ID. When unsaved records are included in the input payload, they are automatically created in Salesforce before the grid renders, removing the need to pre-create records manually before passing them as input.

***

<h2 align="center"><mark style="color:purple;">Matrix Updates</mark> <span data-gb-custom-inline data-tag="emoji" data-code="2728">✨</span></h2>

### Matrix Timeline Enhancements

The matrix timeline offers more flexibility in how date intervals are configured and displayed on the X-axis.

<figure><img src="/files/jvOKealv0TvDLv7ltJCa" alt=""><figcaption><p>Matrix Timeline</p></figcaption></figure>

#### Salesforce Fiscal Year Support in Matrix Timelines

[Matrix timelines](/valorx-wave/matrix/matrix-configuration.md#year-type) support Salesforce fiscal calendars. When the **Fiscal** year type is selected, X-axis date buckets align with the fiscal periods configured in your Salesforce org — across weeks, months, quarters, and years. If fiscal settings are not configured, the matrix falls back to standard calendar-based timeline generation.

<div align="left"><figure><img src="/files/YxvQAPeuSi32oYh6BUxY" alt="" width="397"><figcaption><p>Year Type</p></figcaption></figure></div>

#### More Flexibility in Telescopic Matrix Timelines

Telescopic timelines now support **week-based** combinations, including:

* Weeks → Quarters → Years
* Weeks → Months → Quarters → Years

<div align="left"><figure><img src="/files/V4d0yTMt4ZpZkWFpnY6r" alt="" width="442"><figcaption><p>Weeks</p></figcaption></figure></div>

#### Custom Date

The **Choose Date Format** dropdown includes a **Custom** option, allowing you to define your own date format for X-axis column headers using supported date tokens, labels, and separator characters.

The following tokens, labels, and separators are supported:

<table><thead><tr><th width="194">Type</th><th>Supported Values</th></tr></thead><tbody><tr><td>Date tokens</td><td>DD, {W}, MM, MMM, MMMM, {Q}, YY, YYYY</td></tr><tr><td>Labels</td><td>W, Wk, Q, FY</td></tr><tr><td>Separator characters</td><td>\ / , . : ; ' ` ~ ! ( ) [ ]</td></tr></tbody></table>

<div align="left"><figure><img src="/files/x9rZsEPbuuLkBNf0lBZJ" alt="" width="435"><figcaption><p>Custom Date</p></figcaption></figure></div>

### Matrix – Two-Level X-Axis Configuration

The [matrix X-axis](https://docs.valorx.com/valorx-wave/release-notes/wave-embedded/pages/309VTXFMBeFBzBOF1W5o#id-2.-column-x-axis) now supports two levels of column headers, allowing data to be grouped and displayed hierarchically or inline across two dimensions. Designers can configure how the two levels are displayed either as a parent-child hierarchy or combined into a single header using a separator of their choice giving users a clearer, more structured view of comparative data.

<figure><img src="/files/NJ7mQ5zTycOd64NI9ie8" alt=""><figcaption><p>Matrix Two level X-axis </p></figcaption></figure>

### Rules in Matrix

[Rules](/valorx-wave/wave-data-management/managing-grid-data/rule.md) are now available in the Matrix, bringing the same rules capability from the Grid to the Matrix. Designers can define conditions using fields from the Y-axis, X-axis, and data objects, and apply a range of formatting actions to cells, rows, and columns. New matrix-specific actions include Column Format and Column Highlight, which apply formatting to X-axis columns and their data cells. Filter by Color for rule-driven filtering is supported on the Y-axis.

<figure><img src="/files/bFdky0qglXF8QiYEKpr9" alt=""><figcaption><p>Rule in Matrix</p></figcaption></figure>

### Multi-Record Selection for Embedded Matrix on Record Pages

The Matrix now supports multiple record inputs, enabling Designers to configure matrices that render based on a dynamic set of records rather than a single record. Using a Salesforce Screen Flow with a Valorx Grid for record selection, users can select records once and have them passed simultaneously into multiple matrices eliminating the need to configure each matrix independently. This unlocks use cases such as rendering two related matrices from a single record selection step.

***

<h2 align="center"><mark style="color:purple;">New Update</mark> <span data-gb-custom-inline data-tag="emoji" data-code="2728">✨</span></h2>

### Scheduled Job Configuration — Wave Admin Panel

Admins can now manage the scheduling of managed package jobs directly from the Wave Admin tab, without needing to use Apex or Salesforce Setup. A new **Configuration** page lists all available jobs, each with a Cron Expression field that can be updated at any time. Jobs are automatically scheduled during package installation with a default schedule pre-filled.

<figure><img src="/files/tdxcu25nx8BuYWz8njWY" alt=""><figcaption><p>Scheduled Job</p></figcaption></figure>

***

<h2 align="center"><mark style="color:purple;">Minor Enhancements</mark> <span data-gb-custom-inline data-tag="emoji" data-code="1f31f">🌟</span></h2>

### New Record Creation — Updated Experience

Users can now insert a new record directly above or below a specific row using the **+** button on row hover, with an updated animation when records are added.

<figure><img src="/files/2gj1hmsMQQX2Za8mTUYr" alt=""><figcaption><p>New Record Creation</p></figcaption></figure>

### Related List – Field Configuration

Designers and Admins can configure fields at the related list level from the Grid Wizard without impacting the main grid. Each related list entry includes a **Configure** button to control which fields are required, hidden, read-only, or have default values.

<figure><img src="/files/rp8c17kdCT8gH2WmtZFc" alt=""><figcaption><p>Related List - Field Configuration</p></figcaption></figure>

### Required Fields Validation on Record Updates

Fields marked as Required are now enforced on both record insertion and update operations, ensuring data consistency across all changes. Applies to Fields Configuration in the Grid and Data Config in the Matrix.

<figure><img src="/files/mCfMjdGZR5GR8jdYy3zs" alt=""><figcaption><p>Required Field</p></figcaption></figure>

### Improved Error Messages in Embedded Mode

Error messages in the embedded Wave Grid and Matrix have been updated to use plain language with clear next steps, replacing technical references with user-friendly guidance.

<figure><img src="/files/QmY5IyzIKN2bpm1ZaGAq" alt=""><figcaption><p>Error Message</p></figcaption></figure>

### Column Group — UI and Behavior Enhancements

Columns can now be reordered by dragging within the Column Grouping overlay. The field panel is scrollable, the controlling field is automatically scrolled into view on edit, and behavior is consistent across both entry points.

<figure><img src="/files/3OeDCpWJgUFdSJKFclfS" alt=""><figcaption><p>Column Group</p></figcaption></figure>

### Custom Grids Setup Banner

Admins and Designers will see an **Enable Personalized Grids** banner. Clicking **Set Up Now** opens a setup panel to enable Custom Grids for individual grids in one step. The banner dismisses permanently once completed.

<figure><img src="/files/nJTxHCn1MGUbZgxpF9I0" alt=""><figcaption><p>Enable Personalized Grid</p></figcaption></figure>

### Matrix Orientation Toggle

Runtime users can switch the matrix orientation between horizontal and vertical from the toolbar. Each user's preference is saved individually and can be reset to the Designer's default at any time.

<figure><img src="/files/ekaGtEBBhH6kWsCkgwl9" alt=""><figcaption><p>Matrix Orientation Toggle</p></figcaption></figure>

### Matrix – Show Selection for Y-Axis Object

Designers can now control whether users see a record selection window for the Y-axis at runtime. When disabled, all Y-axis records are automatically selected and the matrix renders directly.

<figure><img src="/files/ZftClsMSmeqjagKi9nRL" alt=""><figcaption><p>Show Selection for Y-Axis in Matrix</p></figcaption></figure>

### Matrix – Y-Axis Field Configuration

Designers and Admins can configure Y-axis fields directly from the Matrix Wizard using a **Configure** button, controlling visibility, read-only state, totals, and actions without affecting the main matrix configuration.

<figure><img src="/files/1wAlBHP33M10vhzlJy2u" alt=""><figcaption><p>Field Configuration for Y-Axis</p></figcaption></figure>

***

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

## Wave Embedded v22.2 Hotfix

This hotfix release focuses on improving grid data accuracy and Flow integration reliability.

#### What's Improved

**Grid Action Accuracy After Header Filter Selection**\
Improved Grid Action behavior so that when a Header Filter is applied, selecting all visible records and executing a Grid Action now processes only the filtered records shown, rather than all records in the grid.

**Flow Action Record Data for SObject Parameters**\
Improved Row Action and Grid Action Flow integrations so that selected record data is now correctly passed to Flow SObject parameters, populating fields such as Record Id and Record Name as expected.

**Input Variable Data Type Accuracy in Row/Grid Actions**\
Improved variable handling in Row Action and Grid Action configuration so that newly added Flow input variables now display and set the correct data type, rather than defaulting to the data type of the first input variable.

**Add Variable Button Behavior in Row/Grid Actions**\
Improved the Add Variable experience in Row Action and Grid Action configuration for flows with more than two input variables. The Add Variable button now remains available after selecting a variable, allowing all remaining input variables to be added.

**Date and DateTime Format Handling During Record Duplication**\
Improved record duplication so that Date and DateTime field values are now copied in a valid, Salesforce-supported format, allowing duplicated records to save successfully.

**Date and DateTime Value Persistence via Drag & Drop and Magic Square**\
Improved save reliability for Date and DateTime values entered using Drag & Drop or Magic Square, resolving an issue where changes failed to persist.

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

{% update date="2026-06-24" %}

## Wave Embedded v22.1 Hotfix

This hotfix delivers targeted improvements to Dynamic Grid behavior, grid runtime usability, and lookup field display, along with fixes for matrix rendering, grid actions, and filter synchronization in Snap.

#### What's Improved

**Dynamic Grid — Replace and Append Mode**\
[Dynamic Grid](/valorx-wave/surf-the-wave/publish-the-grid/dynamic-grid.md) now supports two modes: **Replace** and **Append**.

* **Replace Mode** (existing behavior): Incoming fields replace the current grid fields.
* **Append Mode** (new): Incoming fields are merged with existing grid fields and positioned according to the specified sequence. Fields without a sequence are added to the end of the grid.

Dynamic Grid configuration always takes precedence at runtime and remains the source of truth during grid rendering.

**Surf the Wave — Full Screen Button**\
A Full Screen icon is now available in Surf the Wave, positioned after Save Changes. It replicates Published Locations fullscreen behavior including hover state and tooltip.

**Input Records — Lookup Name Resolved Before Save**\
Lookup field names for newly added Input Records now display immediately when a valid lookup ID is provided, without user passing lookup name in input records. Behavior is now consistent between new and existing records.

#### Bug Fixes

**Record Count Not Updated After Y-Axis Filter (Two and Three Object Matrix)**\
The record count now updates correctly after applying a Header Filter or Filter by Color on the Y-axis.

**Grid Actions Fail When Set Variable Uses a Dynamic Field ID**\
Grid actions with a Set Variable configured using a dynamic field ID previously threw a JavaScript error and halted. The dynamic field ID is now resolved correctly and the action executes as expected.

**Incorrect and Duplicate Month Labels on Date Axis (Non-Standard Period Label Schemes)**\
When using NumberByYear, NumberByQuarter, or Custom Period Label Schemes, month labels on the X-axis date axis now resolve correctly based on fiscal calendar position. Duplicate and skipped labels across fiscal-year boundaries are resolved. Date Masking continues to function as an override.

**Blank Screen While Loading Large Matrix**\
A loading indicator is now displayed when a Matrix with many columns is rendering. IPC creation and reset no longer leave the Matrix appearing blank or unresponsive.

**Lookup Filter Sync from Main Grid Not Working for Custom Grid and Valorx Grid in Snap**\
Lookup filters applied on the Main Grid now propagate correctly to Custom Grid and Valorx Grid within Snap. Filtering behavior is consistent whether the filter originates from the Main Grid or the Dashboard.
{% endupdate %}
{% endupdates %}