​
Overview

Magic Embed is a lightweight, client-side solution that lets you automatically generate and embed audio into your articles. Once enabled, it will:

  1. Extract the article content from your webpage.
  2. Generate the audio.
  3. Embed the BeyondWords Player directly into your webpage.

​
Set up

1

Navigate to Magic Embed settings

Go to Project > Settings > Integrations > Magic Embed.

2

Allow website domains

Add the domains where you want Magic Embed to work.

  • Enter your website domain (e.g., yourwebsite.com) and click Add.
  • Magic Embed will only function on pages under these domains.
  • Subdomains will need to be added seperately (e.g. app.yourwebsite.com)
3

Set request headers (optional)

For paywalled or protected content, you may need to provide authentication headers.

  • Add a Header Name and Header Value to authenticate requests.
  • Click + to add multiple headers if needed.
4

Enable Static IP (optional)

If your website requires IP allowlisting, enable this option to use a static IP for content extraction.

5

Choose the content format

Select the embed code that matches the audio or video format you want to embed.

You can only embed video or summaries if you have enabled video or summaries in your project settings.

6

Embed the player

Copy the embed script and add it to your webpage.

<script async defer src="https://proxy.beyondwords.io/npm/@beyondwords/player@latest/dist/umd.js"
  onload="new BeyondWords.Player({
    target: this,
    projectId: <ID>,
    clientSideEnabled: true
  })">
</script>

Replace <ID> with your project ID.

7

Enable Magic Embed

After configuring all settings:

  1. Turn on the Magic Embed switch.
  2. Click Save changes.