how it works

How to add audio player to website

WordPress

When installing on WP, please ensure you use the ‘HTML’ container to post the widget code. Hit preview, and you should be able to see something to show it’s working.

See Players

Webflow

On Webflow, you need to find the CMS pages, add the link with the embed container, and test it on the live site. Then, add the link with the embed container to the CMS pages and test it on the live site.

More Walkthroughs Soon

You can add this widget to your own coded sites from lovable, Next.js, Astro, and much more. Just use the widget in the proper placement.

“beautiful players man”

– first email received

How do I install Audio Player on my blog?

Butter Reader can be installed in two ways:

WordPress (recommended)

Install the Butter Reader WordPress plugin
Connect your Butter Reader account
Choose your audio player design and voice settings
Audio players automatically appear on all blog posts
No coding required

Any Other CMS (Webflow, Squarespace, Ghost, HTML Sites)

Customize the player anytime — updates sync instantly across your site

Copy your embed code from the Butter Reader dashboard

Paste it into your blog template, page header, or post layout

Butter Reader automatically detects the content and generates audio

Where do I find my embed code?

You can get your embed code from:

Dashboard → Players → Select Player → Installation
The embed code looks like:

<script 
  src="https://app.butterreader.blog/widget/AudioPlayerWidget.bundle.js" 
  data-player-id="your-player-id">
</script>

Just paste it wherever you want the audio player to appear.

Do I need coding experience to install Butter Reader?

No.
Butter Reader is built for non-technical creators:

No API configuration, no server changes, no plugins besides ours

WordPress installation is one-click

Embed code just requires copy/paste

Does Butter Reader work on WordPress, Webflow, Squarespace, and Ghost?

Yes — Butter Reader works on every major CMS, including:

WordPress (via plugin or embed)
Webflow
Squarespace
Ghost
Blogger
Wix
Custom HTML blogs
Headless CMS setups
Shopify blogs

Anywhere you can paste a <script> tag, Butter Reader can be installed.

Why isn’t my audio player showing on my site?

Your CMS player is locked to one domain for security.
If the domain doesn’t match exactly, it won’t load.

Solution:
Update domain inside dashboard → Players → Settings → Website Domain.

2. Your theme hides scripts inside content

Some editors like Elementor, Divi, or Shopify sections block scripts.

Solution:
Place the embed code in your theme header, not inside the post content.

3. Browser caching

Hard refresh the page:

Windows: CTRL + SHIFT + R
Mac: CMD + SHIFT + R

4. Plugin conflicts (WordPress only)

JS-minification, optimization, and security plugins can delay script loading.