Skip to content

Getting Started (Experience Cloud)

This page explains how to use Google Client Lightning components in Experience Cloud sites.

Google Client components work in both LWR and Aura-based Experience Cloud sites.

However, Experience Cloud requires additional manual setup compared to Core Clouds.
These steps are mandatory and must be completed before placing components on record pages.

Required setup (must be completed first)

Experience Cloud does not allow components to open arbitrary pages at runtime. For Google Client to support navigation patterns such as View All and File File Details, two dedicated pages must exist in the site.

These pages act as fixed navigation targets and host internal Google Client components.

Pages you must create

You must create two empty Experience Cloud pages with the following URLs:

  • gview-all-files
    • Label/API can be set to something user-friendly (for example: “View All Files”).
    • This page will be opened automatically when users click “View All”.
  • gfile-details
    • Label/API can be set to something user-friendly (for example: “File Details”).
    • This page will be opened automatically when users click “View File Details“.

Step-by-step: creating the required pages

  1. Open Salesforce and navigate to your Experience Cloud site.
  2. Click Builder to open Experience Builder.
  3. In the top-left corner, open the Pages panel.
  4. Click New Page.
  5. Select Standard Page.
  6. Click New Blank Page.
  7. Choose 1 full-width column layout.
  8. Create the first page:
    • Label: View All Files (or similar)
    • API Name: ViewAllFiles (or similar)
    • URL: gview-all-files
  9. Create the second page:
    • Label: File Details (or similar)
    • API Name: FileDetails (or similar)
    • URL: gfile-details

Placing required internal components

After creating the pages, you must place the correct Google Client components on each page.

Page: gview-all-files

  • Open the gview-all-files page in Experience Builder.
  • From the components panel, locate Google Client: All Attachments.
  • Drag the component into the main content area.
  • Use a single, wide section for best results.

Page: gfile-details

  • Open the gfile-details page in Experience Builder.
  • From the components panel, locate Google Client: Record Page Details.
  • Drag the component into the main content area.
  • Use a single, wide section for best results.

After placing both components, click Publish to make the pages available. At this point, navigation used by Google Client components is fully configured.

Components you can place on Experience pages

After completing the setup above, you can safely place Google Client components on record-driven Experience Cloud pages.

Google Client: Attachments

Provides full Google Drive file management for a Salesforce record, serving as a complete replacement for Notes & Attachments.

Where it can be used

  • Experience Cloud record pages

Important configuration notes

  • recordId Use {!recordId} to enable dynamic binding to the current record.
  • objectApiName Set this statically based on the object where the component is placed.

Typical use

  • Main file list for records exposed in Experience Cloud.
  • Automatically opens the “View All Files” page when needed.

Google Client: Uploader

Provides a dedicated upload interface for adding files to Google Drive from Experience Cloud.

Where it can be used

  • Experience Cloud record pages

Important configuration notes

  • recordId Use {!recordId} for dynamic binding.
  • objectApiName Set statically to match the record type used on the page.

Typical use

  • Controlled upload experience for external or community users.

Important notes

  • Both LWR and Aura Experience Cloud sites are supported.
  • The required pages must exist before record-level components will work correctly.
  • API Names must match exactly.
  • Record context must be provided using {!recordId}.