> 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/surf-the-wave/publish-the-grid/experience-cloud-page.md).

# Experience Cloud Page

Applicable to all Experience Cloud sites.

Valorx components can be embedded within **Experience Cloud pages** to provide users with interactive views of Salesforce data.

The following Valorx components are supported:

* **Valorx Grid**
* **Valorx Related Grid**
* **Valorx Grid (LWC)**
* **Valorx Matrix**
* **Valorx Matrix (LWC)**

Before adding a Valorx component to an Experience Cloud page, ensure that the required Salesforce sharing settings are configured.

{% hint style="info" %}
**Note:** The available properties depend on the Valorx component you add to the Experience Cloud page.
{% endhint %}

***

## Experience Cloud Sharing Settings Configuration

Experience Cloud users, including partners and external users, may not be able to access or view Valorx Grids, Matrices, or related configuration data unless the required Salesforce objects have the appropriate external sharing access.

To ensure proper data visibility, set **Default External Access** to **Public Read/Write** for the Valorx-related objects listed below under **Organization-Wide Defaults**.

By default, some Salesforce orgs restrict external access to these objects. If **Default External Access** is set to **Private** or **Public Read Only**, Experience Cloud users may not be able to retrieve the required data, which can result in **blank views or missing content**.

### Required Configuration

In Salesforce Setup, verify that the following objects have **Default External Access** set to **Public Read/Write**.

<table><thead><tr><th width="254">Object</th><th width="278">Default External Access</th><th>Available From Version</th></tr></thead><tbody><tr><td>Access Control</td><td>Public Read/Write</td><td>–</td></tr><tr><td>Actions</td><td>Public Read/Write</td><td>v8</td></tr><tr><td>Data Import</td><td>Public Read/Write</td><td>v18</td></tr><tr><td>Feature Usage Log</td><td>Public Read/Write</td><td>v16</td></tr><tr><td>Filter Collection</td><td>Public Read/Write</td><td>v20</td></tr><tr><td>Logger</td><td>Public Read/Write</td><td>v16</td></tr><tr><td>Lookup View</td><td>Public Read/Write</td><td>–</td></tr><tr><td>Matrix Grid</td><td>Public Read/Write</td><td>v15</td></tr><tr><td>Matrix Data Import</td><td>Public Read/Write</td><td>v23.1</td></tr><tr><td>Related View</td><td>Public Read/Write</td><td>–</td></tr><tr><td>Snap</td><td>Public Read/Write</td><td>v22</td></tr><tr><td>Snap Assignment</td><td>Public Read/Write</td><td>v22</td></tr><tr><td>Snap Related List</td><td>Public Read/Write</td><td>v22</td></tr><tr><td>Usage Log</td><td>Public Read/Write</td><td>v16</td></tr><tr><td>User Preferences</td><td>Public Read/Write</td><td>v23</td></tr><tr><td>Views</td><td>Public Read/Write</td><td>–</td></tr><tr><td>View Configured Location</td><td>Public Read/Write</td><td>–</td></tr><tr><td>View Link</td><td>Public Read/Write</td><td>v22</td></tr></tbody></table>

> **Note:**\
> Some objects were introduced in later versions. For example, **Matrix Grid** was introduced in v15; **Logger**, **Feature Usage Log**, and **Usage Log** were introduced in v16; and **Matrix Data Import** was introduced in v23.1. Verify that the required objects are available in your org before updating their sharing settings.

### Steps to Update Sharing Settings

1. Navigate to **Setup** in Salesforce.
2. Search for and open **Sharing Settings**.
3. Click **Edit** under **Organization-Wide Defaults**.
4. Locate the listed objects under the **Default External Access** column.
5. Set the access level to **Public Read/Write** for each.
6. Click **Save**.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FBjR1dAQR2uxBasdT2yWa%2FSharing%20Settings.gif?alt=media&amp;token=25457a56-9e50-43d7-bd51-6250aa928588" alt=""><figcaption><p>Sharing Settings</p></figcaption></figure>

Make sure the required sharing settings are configured before continuing with the component setup.

***

## Add a Valorx Component

After completing the required configuration, add the Valorx component to your Experience Cloud page.

{% stepper %}
{% step %}

#### **Access the Experience Cloud Editor**

* Ensure your Community Portal is set up.
* Navigate to **All Sites** and select your community site.
* Click **Builder** to open the Experience Cloud editor.&#x20;

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FypjSzbOy5GN2ePDBIcsq%2FCommunity%20Portal%20Page%20P1.gif?alt=media&amp;token=2b09a2b2-1633-4ef8-9e4a-c1149232e925" alt=""><figcaption><p>Access the Experience Cloud Editor</p></figcaption></figure>
{% endstep %}

{% step %}

#### Add and Configure the Valorx Component

1. In the **Components** panel, locate the Valorx component you want to use.
2. Drag and drop the component onto the desired location on the page.
3. Select the component to open its configuration properties.

You can add any of the following components:

* **Valorx Grid**
* **Valorx Related Grid**
* **Valorx Grid (LWC)**
* **Valorx Matrix**
* **Valorx Matrix (LWC)**

Then, configure the properties displayed in the component property panel. The available properties vary depending on the component you selected.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FGqV4SpGicF7TFeVwdUES%2FCommunity%20Portal%20Page%20P2.gif?alt=media&amp;token=a25c728e-12b3-4ea8-888b-8a62b1cd6c02" alt=""><figcaption><p>Add the Valorx Grid Component</p></figcaption></figure>

### Valorx Grid

The **Valorx Grid** component displays a configured Valorx Grid on an Experience Cloud page.

Configure the following properties:

<table><thead><tr><th width="270">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Valorx Grid</strong></td><td>Select the Valorx Grid to display.</td></tr><tr><td><strong>Allow switching between Global Grid Views</strong></td><td>Allows users to switch between available Global Grid Views.</td></tr><tr><td><strong>Height (px)</strong></td><td>Specifies the height of the Grid in pixels.</td></tr><tr><td><strong>Input Variables</strong></td><td>Provides input variable values to the Grid.</td></tr><tr><td><strong>Input Records</strong></td><td>Provides input records to the Grid.</td></tr><tr><td><strong>Output Records</strong></td><td>Defines the output records generated by the Grid.</td></tr></tbody></table>

### Valorx Related Grid

The **Valorx Related Grid** component displays Grid data related to the current Salesforce record in Record page.

Configure the following properties:

<table><thead><tr><th width="270">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Valorx Grid</strong></td><td>Select the Valorx Grid to display.</td></tr><tr><td><strong>Relationship Name</strong></td><td>Specifies the relationship used to retrieve related records.</td></tr><tr><td><strong>Allow switching between Global Grid Views</strong></td><td>Allows users to switch between available Global Grid Views.</td></tr><tr><td><strong>Height (px)</strong></td><td>Specifies the height of the Grid in pixels.</td></tr><tr><td><strong>RecordId</strong></td><td>Specifies the Salesforce record ID used to retrieve the related records.<br>Enter <strong>{!recordId}</strong> for <strong>RecordId</strong> <em>(required – avoids grid load errors)</em>.</td></tr><tr><td><strong>Input Variables</strong></td><td>Provides input variable values to the Grid.</td></tr><tr><td><strong>Output Records</strong></td><td>Defines the output records generated by the Grid.</td></tr></tbody></table>

> **Tip:** Use **Valorx Related Grid** when you want to display Grid data related to the Salesforce record currently being viewed.

### Valorx Grid (LWC)

The **Valorx Grid (LWC)** component provides a Lightning Web Component-based option for displaying a Valorx Grid on an Experience Cloud page.

Configure the following properties:

<table><thead><tr><th width="282">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Valorx Grid</strong></td><td>Select the Valorx Grid to display.</td></tr><tr><td><strong>Allow switching between Global Grid Views</strong></td><td>Allows users to switch between available Global Grid Views.</td></tr><tr><td><strong>Height (px)</strong></td><td>Specifies the height of the Grid in pixels.</td></tr><tr><td><strong>Relationship Name</strong> <em>(Optional)</em></td><td>Specifies the relationship used to retrieve related records.</td></tr><tr><td><strong>Input Variables</strong> <em>(Optional)</em></td><td>Provides input variable values to the Grid.</td></tr><tr><td><strong>RecordId</strong> <em>(Optional)</em></td><td>Specifies the Salesforce record ID associated with the Grid.</td></tr><tr><td><strong>Input Records</strong></td><td>Provides input records to the Grid.</td></tr><tr><td><strong>Output Records</strong></td><td>Defines the output records generated by the Grid.</td></tr></tbody></table>

> **Note:** **Relationship Name**, **Input Variables**, and **RecordId** are optional for Valorx Grid (LWC).

### Valorx Matrix

The **Valorx Matrix** component displays a configured Valorx Matrix on an Experience Cloud page.

Configure the following properties:

<table><thead><tr><th width="210">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Valorx Matrix</strong></td><td>Select the Valorx Matrix to display.</td></tr><tr><td><strong>Height (px)</strong></td><td>Specifies the height of the Matrix in pixels.</td></tr><tr><td><strong>RecordId</strong> <em>(Optional)</em></td><td>Specifies the Salesforce record ID associated with the Matrix. <br>Enter <strong>{!recordId}</strong> for <strong>RecordId</strong> <strong>(required for use on a Record page)</strong>. Without this value, the Matrix is treated as an app page component rather than a Record page component.</td></tr><tr><td><strong>Input Variables</strong></td><td>Provides input variable values to the Matrix.</td></tr></tbody></table>

### Valorx Matrix (LWC)

The **Valorx Matrix (LWC)** component provides a Lightning Web Component-based option for displaying a Valorx Matrix on an Experience Cloud page.

Configure the following properties:

<table><thead><tr><th width="213">Property</th><th>Description</th></tr></thead><tbody><tr><td><strong>Valorx Matrix</strong></td><td>Select the Valorx Matrix to display.</td></tr><tr><td><strong>Height (px)</strong></td><td>Specifies the height of the Matrix in pixels.</td></tr><tr><td><strong>RecordId</strong> <em>(Optional)</em></td><td>Specifies the Salesforce record ID associated with the Matrix. <br>Enter <strong>{!recordId}</strong> for <strong>RecordId</strong> <strong>(required for use on a Record page)</strong>. Without this value, the Matrix is treated as an app page component rather than a Record page component.</td></tr><tr><td><strong>Input Variables</strong></td><td>Provides input variable values to the Matrix.</td></tr></tbody></table>
{% endstep %}

{% step %}

#### **Preview and Publish**

* Click **Preview** (top-right corner) to check the grid’s appearance.
* Once confirmed, click **Publish** to make changes live.
* Log in as a **Community User** to confirm the Valorx Grid is visible.&#x20;

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F7672er3Jj0DKYzkhpDbc%2FCommunity%20Portal%20Page%20P3.gif?alt=media&amp;token=4c658377-c51a-4db3-9723-03700d2bc0d8" alt=""><figcaption><p>Preview and Publish</p></figcaption></figure>
{% endstep %}
{% endstepper %}

Your Valorx component is now successfully embedded in the Experience Cloud page.

***