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.