Loading

Field Service Mobile: Experience Cloud webview instead of native Driver App UI for Partner Community users

Publish Date: Jun 3, 2026
Description

Description

Field Service Contractor Plus users authenticate successfully into the Salesforce Field Service Mobile app (FSM) using the Experience Cloud community site URL as the Custom Host (for example, your-domain.my.site.com/contractors) — this is the correct and expected login URL for Partner Community users. However, instead of seeing the native Driver App UI (Clock In, schedule, job management), the app displays the Experience Cloud community home page rendered in a webview.

Internal users with full Salesforce licenses use the org domain (your-domain.my.salesforce.com) as the Custom Host and see the native Driver App UI. Partner Community users must use the community site URL — but when the correct permissions are not configured, the FSM app falls back to rendering the Experience Cloud webview instead of the native UI.

Scope

This article covers Salesforce Field Service Mobile app Custom Host configuration and permission set requirements for Partner Community users with Contractor Plus licenses to access the native Driver App UI. For general Partner Community authentication issues or data sync problems, see related articles.

Symptoms

• Partner Community users log into Field Service Mobile app successfully
• App displays Experience Cloud community page in webview format
• Native Driver App UI (Clock In, schedule, job details) does not appear
• Internal users with full licenses see native UI correctly
• Authentication completes but wrong interface renders
• Login errors may appear after clearing cached sessions if the user's default login is tied to the Experience Cloud site

Resolution

Cause

The community site URL (for example, your-domain.my.site.com/contractors) is the correct and required Custom Host for Partner Community users in the Field Service Mobile app. The webview rendering issue is not caused by the URL itself — it is caused by missing or incomplete permission configuration on the contractor user.

The native Driver App UI requires all of the following to be configured correctly:

  1. The FieldServiceMobileStandardPermSet permission set assigned directly to the user (not only via a Permission Set Group)
  2. API Enabled system permission enabled on the Field Service Mobile permission set license
  3. The community site URL used as the Custom Host on the FSL mobile app (for example, your-domain.my.site.com/contractors)

Resolution

Step 1: Assign the FieldServiceMobileStandardPermSet Permission Set

This is the critical missing step that is most commonly overlooked — permission sets assigned via a Permission Set Group (PSG) may not include this specific permission set.

  1. Go to Setup > Users and locate the affected contractor user.
  2. Click Permission Set Assignments > Edit Assignments.
  3. Add the permission set: FieldServiceMobileStandardPermSet.
  4. Save.

Step 2: Enable API Enabled on the Field Service Mobile PSL

  1. Go to Setup > Permission Set Licenses.
  2. Open the Field Service Mobile permission set license.
  3. Ensure the API Enabled system permission is enabled.
  4. Save.

Step 3: Verify Full Permission Set Requirements

Ensure the contractor user has all of the following:

  • Partner Community User profile
  • Field Service Mobile permission set license (PSL) assigned
  • FieldServiceMobileStandardPermSet permission set assigned (direct assignment, not only via PSG)
  • Field Service Mobile permission set assigned
  • Field Service Resource Permissions permission set assigned
  • An active Service Resource record linked to the appropriate Service Territory

Step 4: Confirm the Correct Custom Host URL

The Custom Host for Partner Community users in the Field Service Mobile app must be the Experience Cloud community site URL — not the org domain. Ensure the Custom Host is set correctly.

  • Correct: your-domain.my.site.com/contractors
  • Incorrect: your-domain.my.salesforce.com (this is for internal full-license users only)

Step 5: Clear Cached Session

  1. Open the Field Service Mobile app.
  2. Go to Settings and select Log Out completely.
  3. Clear the app's cached data or reinstall the app.
  4. Relaunch the app and confirm the Custom Host is set to the community site URL (eg: your-domain.my.site.com/contractors).
  5. Log in using the contractor user credentials.

Step 6: Test Native Driver App Access

After logging in with the community site URL as the Custom Host and all permissions correctly assigned, the native Driver App UI with Clock In, schedule, and job management features should appear.

Note on Password Reset: If a password reset email redirects the user to the Experience Cloud site login rather than the app, this is expected behavior for community users. The user can proceed to log in normally via the community URL in the FSL app.
Knowledge Article Number

005384624

 
Loading
Salesforce Help | Article