Voxey WordPress Plugin settings

To start setting up the Text-to-Speech plugin open the Voxey settings in your WordPress Dashboard sidebar menu.

In the plugin settings, there are several tabs responsible for various groups of plugin settings.

Speech Synthesis Settings

The tab describes the basic settings of the plugin, the selection of voices and features of speech synthesis.

Access key/Secret key

When you first run the plugin, you need to connect your Access key, Secret key and select the Region with speech synthesis servers closest to you. You can learn where to get the keys from the article How to get Amazon Polly Text-to-Speech Access Keys.


Choose the region with speech synthesis servers closest to you for better performance. The number of available languages and voices may vary by region.

Access and Secret key

Once all the key settings are entered press Save to get the language and voice settings.

Now used

Shows which voice is selected now, and also allows you to listen to the voice sample chosen with default settings.

Now used player


Select the required language for reading from the list and the available voice in the table. After selecting a language, you can filter the table by voice type and gender.

Review available Voices in Amazon Polly and Amazon Polly Pricing

To select and activate a voice, click on the row in the table. The selected voice will be highlighted in blue.

Sample Rate

As with standard voices, you can choose from various sampling rates to optimize the bandwidth and audio quality for your application. Valid sampling rates for standard and neural voices are 8 kHz, 16 kHz, 22 kHz, or 24 kHz. The default for standard voices is 22 kHz. The default for neural voices is 24 kHz. 

Synthesize audio on save

This setting enables automatic speech synthesis when you press the Update button or Publish Button.

This option can significantly increase the cost of your monthly AWS quota.

Turning on this option every time you make changes to the page and save them all the contents of the old page will be sent for speech synthesizing. For example:

  • you created a post of 5000 characters in size and Published it – your content automatically sent to AWS and voiced. 5000 characters will be written off from your balance
  • you add one comma (one character) to the text and click Save – 5001 characters will be automatically sent for speech synthesizing. 5001 symbols will be deducted from your balance

Post Types

The tab contains settings for choosing the types of posts for audio generation and applying speech template as default for every post type.

Post Types

Select the post types, including custom post types to work with the Voxey. The available types are in the drop-down list. Once new post types are added to your site, they will be displayed in the list.

Post Types list of the Voxey

The Voxey can only work with public posts. There are various reasons for this:

  • the plugin is GDPR-compliant, which means it can’t use private information.
  • the audio of a post/page is generated based on the current page markup available publicly.

If you use password-protected post types that are available only for certain users or a group of users, the Voxey can’t work with them.

Speech Templates

The settings section allows you to apply Speech Templates as default for each of the post types that you select in the Post types field. You can create new Speech Templates when editing or creating a page/post.

Default Speech Templates of the Voxey

Audio Content

Before Audio

The option allows you to add text that will be added at the beginning of the audio file. For example, you can add an invitation or copyrights.

After Audio

The option allows you to add text that will be added to the end of the audio file. For example, you can add farewell or copyrights.

Read the Title

The option allows you to voice the Title of the current post/page when generating audio.

The setting can be applied only to the default Speech Template “Content

Read the Quotes

The option allows you to voice the quotes in the current post/page when generating audio.

Read the Image Caption

The option allows you to voice the Image caption of the current post/page when generating audio.

Read image alt

The option allows you to voice the Image alt in the current post/page when generating audio.


The option allows you to customize the length of pauses after dots, commas and for table row/cell when generating audio.

Regular expression replacements

With this option, you can replace any group of characters when voicing by using Regular Expressions

Enter the regular expression to be replaced and on a new line write the term or SSML tag to be replaced. You can also use the WordPress filter voxey_after_content_regex_replace to manipulate content for voicing

An example of replacing a number from 1 to 9 with the letter “a

The shortcodes can not be used in the regex rules. You should use SSML

Audio Player

The tab contains settings related to the design of the Player and its surrounding elements.

Player position

You can select one of the available player positions:

  • Before Content
  • After Content
  • Top Fixed
  • Bottom Fixed
  • Before Title
  • After Title
  • Before in Custom Filter – the option provides a field for entering a theme filter or a custom filter before which the player will be added.
  • After in Custom Filter- the option provides a field for entering a theme filter or a custom filter after which the player will be added.
  • WordPress Hook(action) – the option provides a field for entering a custom WordPress action to which the player will be added.
  • Shortcode [voxey] – shortcode allows you to add a player anywhere on the page.

Some themes may have problems displaying the player in the Before Title and After Title positions. Switch the player to another position in such cases.

You can easily add the Voxey WordPress Plugin player anywhere on the page using the shortcode [voxey]. You can also show the player with an audio recording of another post using the shortcode [voxey id=PAGEID] where PAGEID is the id of the page of the audio version which you want to use in the player.

Speaker WordPress Plugin
Page ID

You can find out the page ID in the address bar during editing or from the page code.

Player Style

The plugin has six predefined player styles that you can use on the website pages. You can also customize any of the presented player templates with CSS.


Core WordPress player with round edges:

Round Talker Audio Player
Round Voxey Audio Player

Core WordPress player with rounded corners:

Rounded Talker Audio Player
Rounded Voxey Audio Player

Core WordPress player with right angles and straight edges:

Squared Talker Audio Player
Squared Voxey Audio Player

Regular WordPress audio player:

WordPress Default Audio Player
WordPress Default Audio Player

Default browser player without any styles and scripts. The appearance of the player is different in different browsers:

Chrome & Opera Audio Player

The Chrome & Opera Audio Player have a link to download the audio file even when the Download Link is hidden in the plugin settings.

Safari Audio Player
FireFox Audio Player

Please note that when choosing a Browser Default Player, a standard WordPress player will be disabled on your site. This will have an effect for all players on all pages of your site.

To fine-tune the design of the player, use the CSS class .mdp-voxey-box

Background color

This setting allows setting the background color of the player. This is possible for all modes except WordPress Default Player and Browser Default Player

The setting determines how to display the download link. You can choose one of these options:

  • Do not show
  • Backend Only
  • Frontend Only
  • Backend and Frontend
Speaker WordPress Plugin Download link
Download the link on the Frontend
Speaker WordPress Plugin Download link
Download the link on the Backend

Speed controls

The option allows you to enable the control panel for the speed of audio playback. When the option is enabled, two additional settings are available:

  • Speeds section title – enter the title that will be displayed before the speed settings panel.
  • Available speeds – a field allows you to enter speed values that will be available to the user. The speed values must be separated by commas. Use period for decimal numbers, for example, 1.2, 1.5, 1.75.
Backend Speed settings
Audio speed control on frontend

Audio Preload

The preload attribute specifies if and how the audio file should be loaded when the page loads.

The audio preload options
  • None – the browser should NOT load the audio file when the page loads.
  • Metadata – the browser should load only metadata when the page loads.
  • Auto – the browser should load the entire audio file when the page loads.
  • Backend – the browser should NOT load the audio file but the plugin requests information about the file on the backend and saves its duration in HTML.


The option allows playing audio after the page loads. Some browsers do not allow autoplay for any audio or video according to their policy, so this feature may not work for certain browsers.

WordPress default playerNoNoYesNoYes
Browser default playerNoNoYesYesYes

The table with listed browsers that support the autoplay feature


The option allows looping the audio playback.


Section for configuration of the audio files storage, metadata and audio file names customizing.

Audio File Name

The option allows you to change the name of the generated audio files using available patterns: [id] – post ID; [name] – post slug; [title] – post title; [author] – post author; [type] – post type.

If you change the Audio File Name, the audio files with the old name will no longer be displayed as audio for the post.

Custom fields

The toggle to enable/disable the feature of saving data about the generated audio file in meta fields has been added. Read more in the guide.

Media Library

The toggle to make the audio file visible and available in the Media Library.

Note: The files that were generated before the option was enabled will not be displayed.

Speakable Markup

The toggle to enable/disable the Speakable markup option for the post/page selected in the Voxey>Post Types.

The speakable schema.org property identifies sections within an article or webpage that are best suited for audio playback using text-to-speech (TTS). Adding markup allows search engines and other applications to identify content to read aloud on Google Assistant-enabled devices using TTS. Web pages with speakable structured data can use the Google Assistant to distribute the content through new channels and reach a wider base of users.

The additional options are available when the Speakable Markup toggle is On.

  • For all posts – an option to enable the markup even for posts without an audio file generated.
  • JSON+LD Markup – a field modify JSON+LD markup in regards to the Speakable Markup Guide. The default markup version also works correctly.
Speakable markup settings


An option that allows you to create an RSS podcast feed for any podcast service based on audio generated on your site.

Create RSS feed podcasts following the RSS feed guidelines for Google Podcasts,or Apple Podcaster’s Guide to RSSSpotify Podcast Delivery Specification or other podcast services.

Google Podcasts is going away in 2024. Learn more about the Google Podcast turndown in our blog. Google Podcasts Manager users can now upload their podcasts to YouTube with RSS upload. Learn more here

There are available Header and Item fields of the template when the RSS option is enabled.

Podcasts feed settings

Once all the configuration is done the feed will be available at the link http://localhost:8888/voxey?feed=voxey-podcast

To get a feed only with posts of a certain category, use the link


Where cat = "category ID"

To get a feed only with posts of a certain tag, use the link


Where tag="tag slug"

Create root file

The option allows you to create Create RSS file in website’s root https://yoursitelink/podcast.xml

Advanced Settings

Advanced settings allow you to configure before and after player content as well as manage user rights. Please make sure you understand what you are doing before changing anything on this tab.

Content before the player

The toggle enables the enter field for adding a text, image or HTML markup before the audio player.

The toggle to display content before the player

Content after the player

The toggle enables the enter field for adding a text, image or HTML markup after the audio player.

Display in loop

The option to display a player only for loop queries.

Can manage audio files

The option to select the user roles that will have access to create, re-create, remove audio and speech templates. Find out more about user roles and capabilities in WordPress.

Save Changes

Do not forget to click Save Changes after changing plugin settings. After clicking this button, the settings will be saved and applied to all pages of the website.

Now you can proceed to use the plugin on the pages of your WordPress website. Please read the article Converting WordPress page to speech and Speech Synthesis Markup Language (SSML) in the Voxey WordPress plugin.

Was this article helpful to you?