Why does the DRTE e-signature portal appear as a completely blank page on certain iOS devices (while rendering properly on Android), and how can we prevent this for signers?

Published on October 3, 2026 DRTE

This behavior occurs when JavaScript is disabled in the mobile browser settings (e.g., Safari on iOS) or blocked by strict mobile privacy/content settings.

Because DRTE components (such as the Editor LWC and Guest User Signing Portal) are built on Salesforce Lightning Web Components (LWC), they require client-side JavaScript to execute and render the document interface. If JavaScript is turned off, the browser cannot load the LWC framework, resulting in a blank white screen—a standard constraint across all native Salesforce LWC applications.

1. Quick Resolution for Affected Signers

Instruct the affected user to enable JavaScript on their iOS device:

Open Settings on the iPhone or iPad.
Scroll down and tap Safari.
Tap Advanced at the bottom of the page.
Toggle JavaScript to ON.
Re-open or refresh the e-signature portal link.

2. Administrative Best Practice: Add <noscript> Head Markup

To ensure signers are never left confused by a blank screen if JavaScript is disabled on their browser, add a fallback notification tag to your Experience Cloud Site:

Open Experience Builder:

Navigate to Setup → Digital Experiences → All Sites and click Builder next to your public DRTE signing portal.

Access Head Markup Settings:

Click the Gear Icon (Settings) on the left navigation panel.
Select Advanced and click Edit Head Markup.
Inject <noscript> Fallback Tag:
Paste a custom fallback message into the editor:

<h2>JavaScript is Required</h2>

<p>To view and electronically sign this document, please enable JavaScript in your browser settings and refresh this page.</p>

</div>

</noscript>

Publish Changes:

Click Save, then click Publish in the top-right corner of Experience Builder.

Knowledge Article Number: KA-00444