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. On paid plans, an Unlisted player can be locked with an access password that gates both the direct link and any embed.
• Private — owner-only; embeds won't render for visitors.

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.