Blank Screen on eSign Portal (iOS/Mobile Devices)

Issue Summary

Users attempting to access the eSign Portal via iOS devices (iPhone/iPad) or mobile browsers may encounter a persistent blank page instead of the document signing interface.

Root Cause

The eSign Portal is built using Salesforce Lightning Web Components (LWC). LWC requires JavaScript to be enabled in the browser to render the user interface and execute business logic. If JavaScript is disabled within the mobile browser settings (Safari, Chrome, etc.), the application will fail to load, resulting in a blank screen.

Technical Details

• Dependencies: The DRTE editor & eSign components are JavaScript-heavy frameworks.
• Platform Behavior: This is not limited to eSign; most native Salesforce applications and modern web portals require JavaScript to function.
• Replication: The issue can be consistently reproduced by toggling "JavaScript" to OFF in the device's browser settings.

Resolution / Workaround

To resolve this issue, users must ensure that JavaScript is enabled on their mobile device.

For iOS (Safari):

1. Open the Settings app.
2. Scroll down and tap Safari.
3. Scroll to the bottom and tap Advanced.
4. Toggle the JavaScript switch to ON (Green).
5. Refresh the DRTE eSign Portal page.

For Chrome (Mobile):

1. Open the Chrome app and tap the three dots (...).
2. Select Settings > Content Settings.
3. Ensure JavaScript is set to Allowed.

Note: If JavaScript is enabled and the screen remains blank, please clear your browser cache or ensure you are not using "Private/Incognito" mode, as certain high-security settings can occasionally block script execution.

Add the <noscript> tag to the Head Markup:

• In your Experience site, navigate to the Experience Builder.
• Click the Settings gear icon on the left sidebar.
• Select Advanced.
• Look for an option "Edit Head Markup".
• Paste the following code into the head markup editor:html
  

<noscript>

JavaScript is disabled in your browser. Some features of this site may not function properly without it. Please enable JavaScript for the best experience.

</noscript>

The content within the <noscript> tags will only be displayed if the user's browser has JavaScript disabled.