How it works

A short overview of what the embed does in your page — useful when you are wiring templates or debugging layout.

Finding players on the page

  • On load, the script looks for elements with data-voicgen-player and a data-post-id.
  • If your app adds markup after load (single-page apps, lazy sections), new players are still picked up automatically.
  • Each player renders inside Shadow DOM, so its styles stay separate from your site CSS.

Loading and playback

The script connects to Voicgen using your page's hostname and the post_id you set. If audio is still being created, the bar can show a loading state until it is ready. If something goes wrong or there is no audio for that id, the empty container may disappear so readers do not see a broken control.

Listening and analytics

Playback actions (play, pause, progress, and similar) can be recorded for your Voicgen analytics. You do not add tracking code yourself for standard listening behavior.

BillingIf your Voicgen subscription is not active, the player may not appear for visitors until billing is resolved in the dashboard.