Setup and operations

Embedding a Routed Destination with Iframe Delivery

Iframe delivery is viable only when the selected destination permits framing and its complete user journey works inside the container.

Confirm the destination can be framed

Inspect current response headers and application behavior for both pages, including frame restrictions and authentication. Do not attempt to bypass an upstream owner's framing policy; choose another delivery mode when embedding is disallowed.

Design the containing document

Set viewport behavior, iframe dimensions, background, loading state, title, and fallback message. Test small screens and long content because nested scrolling can make a technically loaded page unusable.

Distinguish router and embedded failures

The public document can return successfully while the iframe target is blocked or broken. Monitor destination availability separately and preserve the routing event that selected it.

Run an iframe-specific acceptance pass

Check both selected pages, direct destination access, keyboard focus, mobile scrolling, tracking continuity, and an unavailable upstream. Approve embedding only after the full interaction works without unsafe workarounds.

Related guides