> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Add the Zuora Experience component to a Lightning page

> Add the Zuora Experiences component to a Lightning page, configure its properties, and verify that the experience loads correctly in the iframe.

Add the Zuora Experiences component to a Lightning page, configure its properties, and verify that the experience loads correctly in the iframe.

Open the target Lightning page and click **Edit Page**.

Drag the **Zuora Experiences** component onto the page.

Configure the component properties.

Click **Save**, and then click **Activate**.

Open the page as a permitted user and verify that the experience loads successfully in the iframe. If a page path is configured, verify that the specified page is displayed.

Otherwise, the experience opens the project’s default landing page.

| Property                     | Required | Description                                                                                                                                                                                 |
| ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tenant Slug                  | Yes      | Specify the tenant slug for the Zuora Experiences tenant. You can find the tenant slug in the Zuora Experiences user pages or in Domain Manager.                                            |
| Page Path                    | No       | Enter the landing page path after authentication, for example `/billing/overview`. If you leave this field blank, the experience opens the default landing page configured for the project. |
| External Client App API Name | No       | Leave the default value `Zuora_Experiences` if you used that API name when you created the app. Otherwise, enter the API name of your External Client App.                                  |
| Canvas App Namespace         | No       | Leave blank unless your Salesforce org uses a namespace.                                                                                                                                    |

When the page loads, Salesforce sends a signed request to the configured Canvas App URL. After the request is validated, the experience is rendered in the iframe.