Skip to main content

Embed AtomicPlayer on pages

You can place AtomicPlayer on both Atomicat pages and external sites. The safest workflow is to finish the video settings first, save them, then refresh the page block or embed snippet that visitors will load.

AtomicPlayer embeds carry player options as attributes. Settings such as Magic Resume, Magic Autoplay, Smart Progress, fixed sizing, primary color, pause permission, and simulated live viewers only reach visitors after the page or external embed is updated.

Atomicat pages workflow​

  1. Open the page in the Page Builder.
  2. Add or select a Video element.
  3. Choose the AtomicPlayer/Atomic video option in the video source controls.
  4. Select the AtomicPlayer video asset.
  5. Configure any page-level behavior, such as delayed playback, if needed.
  6. Publish the page.
  7. Open the live page and test the video on the final domain.

On published Atomicat pages, the builder generates the AtomicPlayer markup from the selected video data. You usually do not paste the external embed snippet into a normal Atomicat video block.

External sites workflow​

  1. Open the video in AtomicPlayer settings.
  2. Confirm the domain is allowed in Authorized Domains, or enable Allow all origins intentionally.
  3. Set size, orientation, color, playback, resume, Magic Autoplay, and other options.
  4. Click Save editions.
  5. Click Copy embed.
  6. Paste the snippet into a custom HTML area on the external host.
  7. Publish the external page and test it outside the editor.

The copied snippet normally includes a player element plus the hosted AtomicPlayer bootstrap script. Do not remove the script tag unless your host has a documented way to load it globally.

When to copy a fresh embed​

Copy and replace the external snippet after changing:

  • Magic Autoplay image or standard mode.
  • Magic Resume.
  • Smart Progress.
  • Magic Live Streaming or fake viewer count.
  • Fixed width, height, orientation, or primary color.
  • Start time, playback speed, controls, pause permission, mute, loop, or preload.
  • Initial, pause, or exit thumbnails.
  • Authorized domain settings if the external host changed.

For Atomicat pages, republish the page instead of only saving the video settings.

After-change checklist​

  • Republish every Atomicat page that references the video.
  • Replace pasted HTML on external properties.
  • Confirm the final domain is authorized.
  • Test in a private window and on a mobile device if autoplay matters.
  • Clear the host, CDN, or browser cache if you still see stale thumbnails or player behavior.

Troubleshooting​

  • If the video does not load externally, check Authorize a domain first.
  • If settings saved but the page did not change, republish the Atomicat page or replace the external snippet.
  • If autoplay works on desktop but not mobile, test muted autoplay and review Magic Autoplay.
  • If the embed area is too small, use responsive mode or wrap the external embed in a responsive container controlled by your site host.

Frequently asked questions​

Can I resize the embedded video?

Prefer controlling width and height in Video settings so layouts stay consistent. For external embeds, wrap the snippet in a responsive container you control.

Why does autoplay fail on iOS?

Mobile Safari requires muted autoplay and may still block aggressive patterns—test Magic Autoplay on real devices.

Do I need to copy embed code for Atomicat pages?

Usually no. Use the Video element's AtomicPlayer picker and publish the page. Copy embed is mainly for external sites or intentional raw HTML embeds.

Why did my old embed ignore new settings?

The old snippet may still contain old player attributes. Save the video, copy a fresh embed, replace the HTML on the external host, and publish that host's page.