Put a SoundToggle player anywhere.

Player URLs

Each project has a share URL. Add &embed=true for embedding, and optionally &transparent=true for a transparent background.

https://app.soundtoggle.io/Player?id={PLAYER_ID}

Iframe embed

Copy the exact snippet from any player's Share & Embed dialog in the app — it includes the right height for your layout. The general shape:

<iframe
  src="https://app.soundtoggle.io/Player?id={PLAYER_ID}&embed=true&transparent=true"
  width="100%" height="420" frameborder="0"
  style="border:none;background:transparent;"
  allowtransparency="true" allow="autoplay">
</iframe>

Heights vary by layout (seven layouts: default, waveform, compact, minimal, social, full-width, video sync) — the app's embed dialog fills in the right one. The responsive script embed auto-sizes the frame by listening for the player's soundtoggle-resize postMessage.

Share pages

Every player also has a share page that serves rich previews (Open Graph cards) when the link is posted to social platforms and chat apps:

https://app.soundtoggle.io/api/functions/share?p={PLAYER_ID}

Public players are indexable; unlisted and private players are served with noindex.

oEmbed

SoundToggle serves standard oEmbed responses, so platforms that support link unfurling can render players from a bare URL:

GET https://app.soundtoggle.io/api/functions/oembed?url={PLAYER_URL}

{ "version": "1.0", "type": "rich", "provider_name": "SoundToggle",
  "title": "…", "html": "<iframe …>", "width": 480, "height": 480 }

Visibility & access

• Public — embeddable and shareable by anyone; eligible for the Showcase; indexable.
• Unlisted (default) — the link and embed work anywhere, but the player isn't listed or indexed.
• Private — owner-only; embeds won't render for visitors. Password protection is available on paid plans.

Programmatic player creation

An API for creating players programmatically (upload two files → get back a player URL) is in development. If you're building something that should create SoundToggle players — an app, a workflow, an AI agent — we'd like to hear from you: info@soundtoggle.io.

For AI assistants

A machine-readable summary of SoundToggle — current facts, pricing, and capabilities — lives at soundtoggle.io/llms.txt.