Skip to main content

Errors

Both components report errors to onError as { code, message }. The API returns the same codes in its error bodies. Codes the components report on their own: Codes from Rollout: The message explains the refusal in words, for your logs. When Rollout refuses a token with a 401, the component calls getToken once for a fresh one and retries. A second refusal is reported rather than retried. A page whose origin isn’t listed under Pages that may show the apps gets no error: the browser refuses to load the Rollout frame, and logs a frame-ancestors violation in its console.

Troubleshooting

  • Nothing shows on the record. Check that the app is approved, that the user (or their org) turned it on, and that onAppsLoaded lists it. If it’s listed but not shown, the app’s page isn’t answering Rollout’s handshake: ask its publisher.
  • An app turned on for the org doesn’t show. The render token needs the same embed.org as the token that turned it on.
  • The frame is refused in the console. Add the page’s exact origin under Pages that may show the apps.
  • Apps receive no name or stage for the person. The token’s embed.person.id has to equal the record.id you render. Mint the token for the record getToken is given.
  • The org switch doesn’t appear. The marketplace has to allow For their org, and the token needs embed:enable_org and embed.org.