--- title: "Email Loop Guest Setup" slug: "email-loop-setup" tags: ["Community-Sites", "Admin", "Expanded Content", "LWC"] updated: 2026-10-07T15:47:07Z published: 2026-10-07T15:47:07Z canonical: "documents.revenova.com/email-loop-setup" --- > ## Documentation Index > Fetch the complete documentation index at: https://documents.revenova.com/llms.txt > Use this file to discover all available pages before exploring further. # Email Loop Guest Setup > [!CAUTION] > Warning > > When configuring Digital Experiences Sites, confirm that data isn’t accessible and is secured within security Profiles, Permission Sets, and Sharing Settings. Review all security adjustments to ensure they meet business needs without compromising sensitive data. Set up and configure the Email Loop Digital Experiences Sites for the following guest Digital Experiences Site pages as needed. See additional Salesforce information [here](https://help.salesforce.com/s/articleView?id=000385602&type=1). - [API Guest](/v1/docs/api-site-guest) - [Carrier Guest](/v1/docs/carrier-guest) - [Customer Guest](/v1/docs/customer-guest-new) - [Fleet Guest](/v1/docs/fleet-guest-new) - [Appointment Guest](/v1/docs/appointment-guest-new) > [!NOTE] > All customer and Carrier actions are processed by the [QueuedTransactionJob](/v1/docs/batch-processes#queued-transaction-job), which runs every minute. For more information on creating a Digital Experiences Site, see the [Digital Experiences Sites](/v1/docs/digital-experiences-sites) article. ## Important Settings and Considerations Various settings for the Email Loop should be configured prior to publishing each site for guest users. These settings include: - Public Access - Sharing Rules - Permission Sets > [!NOTE] > Email Loop components only display information when a guest user moves their mouse. This security feature prevents bots from accessing these components. ### Public Access Site Setting > [!CAUTION] > **Warning**: The Public Access in **Settings → General** should **never** be *checked* for the Email Loop site or any associated pages using email loops. The **Public Access Site** setting allows guest users to interact with the Email Loop without logging in. Although this is the purpose of the Email Loop, when *checked*, the Public Access setting allows guest users to access *any* Email Loop, not just the one they were assigned. For example, if an email was sent to a Carrier to confirm booking or tendering a Load, the Carrier would be able to access the Customer Email Loop page, the Fleet Email Loop page, and other guest site pages. Because of this, this setting should remain *unchecked.* ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Email Loop Site General Setting Public Access Unchecked.png) ### Email Loop Sharing Rules For all guest Digital Experiences Sites, guest users must have access to specific records. Create *read-only* Sharing Rules for guest users from **Setup → Sharing Settings** for the following objects: - **Accessorial** - **Accessorial Exclusions** - **Account** - **Appointment Request** - **Carrier Exclusions** - **Carrier Markup** - **Carrier Markup Group** - **Contact** - **Customer Invoice Document** - **Customer Quote** - **Document Options** - **Freight Plan** - **Lane** - **Load** - **Mode** - **Portal Configuration** - **Transportation Profile** - **Trip Plan** - **Truck Posting** - **Zone** ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Appointment Request Sharing Rule Example.png) Complete the following steps for each of the listed objects: 1. Select the object in the picklist for the **Manage sharing settings for** field. 2. Select **New** in the Sharing Rules section. 3. Set the **Label** and **Rule Name** for the Sharing Rule. 4. Select the **Guest user access, based on criteria** option for the **Rule Type**. 5. Enter a criterion such as the following: 1. **Field**: Name 2. **Operator**: not equal to 3. **Value**: any random string of characters (the example uses 123abc.) 6. Set the **Share with** field to **Email_Loop Site Guest User**. 7. Set the **Access Level** field to **Read Only**. 8. Select **Save**. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Appointment Request Email Loop Sharing Rule.png) ### Additional Sharing Settings for Carrier and Fleet Guest Users For specifically Fleet Guest users, sharing settings must be enabled for two objects: - Trip Plan - Fleet Asset Create Sharing Rules for these objects by navigating to **Setup** → **Sharing Settings**. Additionally, to enable Carrier and Fleet Guest users to view Stop locations via Google Maps, specific sharing settings must be configured. After successfully publishing the Email Loop Digital Experiences Site, complete the following steps to enable Google Maps: 1. In your org, navigate to the **TMS Admin** → **Configuration**. 2. Set the **Public Carrier or Fleet Site URL** to the **carrierguest** or **fleetguest** page. Include the **full URL** to the page you created. > [!WARNING] > **Note**: Find this by navigating to **Setup** → **Digital Experiences** → **All Sites**. Click the Email_Loop URL and add the guest page name at the end of the URL. Examples of this are: > > - `https://www.{client_base_url}.my.site.com/email/s/carrierguest` > - `https://www.{client_base_url}.my.site.com/email/s/fleetguest` 3. Navigate to **Setup** → **Salesforce Files** → **General Settings** and ensure that the **Allow site guest users to upload files** field is *checked*. 4. Navigate to **Setup → Trusted URLs** and add a new trusted URL to enable the display of Google Maps with the following fields: - **API Name**: GoogleMap - **URL**: [https://maps.a.forceusercontent.com](https://maps.a.forceusercontent.com) - *Check* all boxes in the **CSP Directives** section. 5. Click **Save**. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Google Map Add Trusted URL(1).png) ## Email Loop Page Setup Depending on the recipient in the Email Loop, distinct guest pages should be created. Within the Experience Builder, create, view, and configure the following Digital Experiences pages to show LWCs and messages to guest users: | Guest User Page Name | Associated LWC(s) | | --- | --- | | appointmentguest | Appointment Request Response | | carrierguest | - Carrier Guest - Carrier Quote - Carrier Settlement - submitCarrierQuote | | customerguest | - Customer Guest - Customer Quote/Accept Decline - Customer Shipment Tracking | | fleetguest | Fleet Driver Confirmation | > [!WARNING] > **Note**: The same Email Loop Digital Experiences Site may be used if it is dedicated solely to the Email Loop for the Carriers, Customers, and Fleet users interacting with it. If the Email Loop is part of a larger Carrier, Customer, or Fleet Site, keep them distinct. Create Digital Experiences Site pages using the following steps: 1. Create a new [Standard Page](https://help.salesforce.com/s/articleView?id=experience.community_builder_create_page.htm&type=5) with the **1 full-width column** layout. 2. Set the required **Name** and **URL** fields depending on the type of page such as **carrierguest** or **customerguest** (all lowercase, no spaces). 3. Select **Create**. 4. Click the **Settings** → **General** tab on the left side of the Experience Builder and configure the following settings: 1. **Important**: Ensure that the [**Public Access**](/v1/docs/email-loop-setup#public-access-site-setting) field is *unchecked*. 2. Select the profile link in the Guest User Profile section. 3. In the **Setup → Profile** page, select **View Users** and complete the following steps: 1. Select the guest user. 2. Assign a Revenova TMS license to the guest user. 3. Create a new permission set based on the [TMS-specific permission set](/v1/docs/digital-experiences-sites#email-loop-digital-experiences-site). Once the Email Loop Digital Experiences Site is published, set the Public Community URL to the guest user page. Include the full URL to the created page. An example of this is `https://www.{client_base_url}.my.site.com/email/s/appointmentguest`. > [!WARNING] > **Note**: If you’re using a custom permission set, confirm that the custom permission set contains the *Create* access on the **Load** object. Though the **Public Access** field should remain *unchecked*, ensure that each guest user page has the **Page Access**. Select the **Page Properties** icon and set the **Page Access** to **Public**. The example below shows the setting on the carrierguest page; however, this setting should be set for *all* guest user pages. > [!NOTE] > The site’s default setting is *Public*. If this setting defaults to *Requires Login*, change to *Public*. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image(32).png) ## **API Guest Access** Because the API Guest user operates in the background and is only used to communicate with API integrations, some permission and sharing settings must be configured prior to implementing the API integration. Complete the following steps to configure the API Guest User access. 1. Navigate to **Setup → Home**. 2. From the Global Search, search for **API Site Guest User** and select the User record. 3. Scroll to the *Permission Set Assignments* section. 4. Click **Edit Assignments**. 5. Search for the **TMS API Community** permission set in the list of available permission sets. 6. Select it and click the **Add** button. 7. Click **Save**. ### SMC3 EVA Documents The SMC3 EVA integration requires enabling an additional Sharing Setting to process documents. Create the Sharing Setting by completing the following steps: 1. Navigate to **Setup → Security → Sharing Settings**. 2. From the *Manage sharing settings for* picklist, choose the **Load** object. 3. Find the *Sharing Rules* section and click the **New** button for **Load Sharing Rules**. 1. Enter a **Label** and **Rule Name**, such as *API*. 2. Enter the following **Criteria**. 1. Field: Select a **Load** field, such as Entry Number. 2. Operator: *not equal to* 3. Value: any random string of characters, such as *xzyasdf123*. 4. Set the **Share with** field to *API Site Guest User*. 5. Set the **Access Level** to *Read Only*. 6. Click **Save**. ## **Carrier Guest Access** The Carrier Guest user must have access to the Email Loop to view messages, footer text, and instructions. See the [Carrier Guest](/v1/docs/carrier-guest) article for more information configuring and customizing the Carrier Guest user’s experience in the Carrier Portal. ### Permission Set Setup Configure permission sets for the Carrier Guest user. 1. Go to **Setup** → **Permission Sets**. 2. Search for the **TMS Carrier Email Loop** permission set. 3. Select the **Clone** link next to the permission set. 4. Remove the value in the **API Name** and **Label** fields. 5. Enter a new value in the **Label** field. > [!NOTE] > Select anywhere outside the field to automatically populate the API Name field based on the new label. 6. Select **Save**. Carriers may need to submit quotes, book Loads, and/or perform other Carrier-related actions. Enable the *Create* access for the **Load** object in the cloned permission set. 1. Select the cloned permission set. 2. In the *Apps* section, select the **Object Settings** link. 3. From the list of objects, select the link to the **Loads** object. 4. Select the **Edit** button. 5. Enable **Create** access in the *Object Permissions* section. 6. Select **Save**. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image(31).png) 1. Return to the **TMS Carrier Email Loop** permission set (not the cloned permission set). 2. Select the **Manage Assignments** button. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/TMS Carrier Email Loop Permission Set Manage Assignments.png) 3. Select the **Email Loop Site Guest** user. 4. Select the **Edit Assignments** button in the *Permission Set Assignments* section. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Permission Set Assignments Edit Assignments Button(1).png) 5. Assign the cloned permission set to the guest user. ![The cloned Carrier Email Loop permission set moved from Available to Enabled for the Email Loop Guest user.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Cloned Carrier Email Loop Permission Set Assign to Guest User.png) 6. Select **Save**. 7. Return to the **carrierguest** page in the Experience Builder for the Email Loop site. ### Carrier Guest LWC Setup Configure the following Carrier Guest LWC properties in the Experience Builder for the Carrier Guest email loop: - **Show Delivered Loads**: When *checked*, this field displays Loads with the *Delivered* status in the Carrier Guest LWC. - **Load Lookback Period**: Enter a numerical value in this field to set the number of days pending and historical Loads appear in the Carrier Guest LWC. - **Load Results List Size**: Enter a numerical value in this field to set the number of Loads per page displayed in the RFQ Load Board LWC. The default value is 25. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image(33).png) ### RFQ Load Board LWC Setup Carriers can access the RFQ Load Board after a few permission sets for objects associated with the RFQ Load Board are enabled. > [!WARNING] > **Note**: Carriers must accept a Load tender first **before** they may access the RFQ Load Board LWC. The RFQ Load Board requires *Read* permissions for the following objects in the cloned **TMS Carrier Email Loop** permission set: - **Accessorial** - **Accessorial Exclusions** - **Carrier Exclusions** - **Carrier Quote** - **Carrier Quote Accessorial** - **Carrier Service** - **Customer Invoice Document** - **Document Options** - **Lane** - **Line Item** - **Load** - **Load Accessorial** - **Mode** - **Queued Transaction** - **Stop** - **Transportation Profile** - **Truck Postings*** - **Contact*** > [!WARNING] > ***Artimus Note**: When accessing the [RFQ Load Board](/v1/docs/carrier-guest#access-via-artimus™-ai-truck-posting-submission) LWC by submitting truck postings via Artimus™ AI, ensure that the **Truck Postings** object and its fields has *Read* permissions in the cloned permission set. The **Contact** object must also have *Read* **object** permissions. Set up the *Read* permission for each object: 1. Go to **Setup → Permission Sets**. 2. Search for and select the cloned permission set from the **TMS Carrier Email Loop**. 3. In the *Apps* section, select the **Object Settings** link. 4. For each object previously listed, perform the following steps: 1. From the list of objects, select the link to the object. 2. Select the **Edit** button. 3. Enable **Read** access in the *Object Permissions* section. 4. *Check* the **Read Access** box in the Field Permissions section. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Cloned Carrier Email Loop Permission Set Object Specific Read Access for RFQ Load Board.png) 5. Click **Save**. 6. Select the **Object Settings** link in the navigation path to return to the list of objects in the permission set. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Permission Sets Object Settings Breadcrumb Link.png) ## **Customer Guest Access** The [Customer Guest](/v1/docs/digital-experiences-sites#customer-portal-digital-experience-site) user operates similarly to the Carrier Guest user. Customer Guest users in the Email Loop site must also have access to the Email Loop to view messages, footer text, and instructions. Configure the Email Loop for the Customer Guest user access. ### Permission Set Setup For each Customer Guest user, ensure there is an assigned a **TMS Customer Community with Login** permission set on the User record. 1. Navigate to **Setup →** **Users**. 2. Click the customer where the permission set should be added. 3. Locate the *Permission Set Assignments* section and click **Edit Assignments**. 4. Locate the **TMS Customer Community with Login** and move to **Enabled Permission Sets**. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/customer_community_login_permission_set.png) > [!CAUTION] > **Note**: Ensure the permission set used for the **Customer Guest Email Loop** has access to the following Apex classes: > > - rtms.AccountCreationController > - rtms.AccountLookupController > - rtms.AILoadWizardController (**for Artimus™ AI only**) > - rtms.CustomerPortalLoadActionsController > - rtms.CustomerPortalPendingLoadsController > - rtms.LaneController > - rtms.LanePreferencesManagerController > - rtms.LanePreferencesUpsertController > - rtms.LightningLoadController > - rtms.LightningUtilController > - rtms.LineItemDetailController > - rtms.LoadTrackingLogController2 > - rtms.LocationLookupController > - rtms.QuoteWizardController > - rtms.StopConfigurationController For more information on configuring the Customer Guest LWC, see the [Customer Guest Shipment Tracking](/v1/docs/customer-guest-shipment-tracking#setup-customer-guest-tracking-page) article. ## **Fleet Guest Access** The [Fleet Guest](/v1/docs/fleet-guest-new#tms-api-community-permission-set) user can access the Fleet Driver Confirmation LWC to confirm or decline a [Trip Plan](/v1/docs/trip-planning#fleet-driver-confirmation). Configure the Email Loop for the Fleet Guest user access. ### Permission Set Setup For each Fleet Guest user, ensure there is an assigned a **TMS Fleet Email Loop** permission set on the User record. 1. Navigate to **Setup →** **Users**. 2. Click the Carrier user where the permission set should be added. 3. Locate the *Permission Set Assignments* section and click **Edit Assignments**. 4. Locate the **TMS Fleet Email Loop** and move to **Enabled Permission Sets**. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/fleet_email_loop_permission_set.png) Once completed, navigate back to the fleetguest page and drag and drop the Fleet Driver Confirmation LWC in the Experience Builder. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/fleet_driver_confirmation.png) ## Appointment Guest Access The [Appointment Guest](/v1/docs/appointment-guest-new) user can confirm, decline, or propose appointment dates and times in the [**Appointment Request Response**](/v1/docs/appointment-request-response) LWC. Configure the Email Loop for Appointment Guest user access. For each Appointment Guest user, ensure there is an assigned a **TMS Appointment Request Email Loop** permission set on the User record. 1. Navigate to **Setup →** **Users**. 2. Click the Carrier user where the permission set should be added. 3. Locate the *Permission Set Assignments* section and click **Edit Assignments**. 4. Locate the **TMS Appointment Request Email Loop** and move to **Enabled Permission Sets**. ![""](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/appointment_guest_user.png) Search for and drag the **Appointment Request Response** LWC onto the page and publish the Digital Experiences Site once complete. ![](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/image(42).png) An equipment or vehicle used in Fleet Management operations. Types include: - Tractor - Trailer - Box Truck - Chassis - Container - Tanker