Skip to content
Ion Academy
Embed

Embedding Content: Best Practices

Embedding places an Ion experience inside a page hosted by another site. The current URL-level Embed code dialog supports two delivery modes: Pop-up, which displays over the host page, and On-page, which displays within the host page content.

Prepare the Ion URL

  • Use a live Ion creative assigned to the intended HTTPS URL.
  • Confirm that the creative’s responsive layouts work at the width available on the host page.
  • Use Hide when embedded for navigation or other elements that should appear only on the standalone Ion URL.
  • Test conversion, integrations, consent, analytics, and external links in an environment that matches the final host page.
Current Ion URL page with the Embed Code button

Choose the embed mode

On the URL page, select Embed Code. Add an optional descriptive embed title for assistive technologies. If no title is provided, Ion uses the first creative’s title.

Choose Pop-up for overlays or sticky bars. Choose On-page for an experience that belongs in the page flow. For on-page embeds, the option to count a visitor only after the content becomes visible can keep off-screen embeds from being counted too early.

Current Ion Embed code dialog with Pop-up and On-page options

Host-page best practices

  • Paste the generated code exactly once for that placement, and do not load duplicate copies of the same supporting script.
  • Allow enough width and stacking order for dialogs, dropdowns, and validation messages.
  • Avoid placing the embed inside a container that clips overflow unless that behavior is intentional.
  • Confirm the host site’s Content Security Policy, cookie consent, and script restrictions allow the generated Ion resources.
  • Test keyboard navigation, focus movement, mobile rotation, and screen-reader naming on the finished host page.
Share this:

Charmaine Yu is a UX/UI designer at Rock Content. With over a decade of experience in visual arts, Charmaine combines her eye for design with her love of UX to create memorable interactive content at Rock. With a UX design diploma from Brainstation, she spent the last couple of years learning and creating new content in the world of UX. Outside of work, you can find her cuddling her dog, at the next music festival or coach-potating at home.