Staging overlay

In-context editing on staging — not production by default.

Prerequisites

• Application allowed domains include your staging origin
• Staging bundles published
• Runtime API key in init()
• Edit JWT (short-lived; never commit)

Mark UI

<p data-i18n-key="common.greeting"></p>

Enable edit mode

Append ?translation_edit=1 to your staging URL and use the Translate launcher (bottom-left).

With admin configured, the launcher redirects to sign in, then returns with #edit_token= in the URL.

await init({
  environment: "staging",
  editLauncher: {
    signInUrl: "https://admin.platform.stringpush.com/overlay-grant",
  },
  // …applicationId, apiKey, etc.
});

Save behavior

Overlay saves update published staging values and trigger a bundle rebuild. Refresh the page to confirm persistence from the CDN.

Production

Production overlay requires an explicit org setting (Business+). Default: staging only.

Security

Credential	Where
Runtime key (trt_…)	Browser — read-only
Edit token	Session storage — overlay writes only

Add every origin (localhost, staging, preview URLs) to allowed domains.