Features Pricing
Blog Documentation Changelog API Reference
Sign In
Get Started

Control what gets narrated

5 min read

By default TTSWP narrates the post title and the main content. You can change both. You can also exclude specific sections (image captions, sidebars, related-posts boxes) and pick which post types get audio at all.

Open the Content settings page

Go to Text to Speech → Content. The page is organized in four sections:

  1. Post types that get audio
  2. Whether to include the post title
  3. CSS selectors to include or exclude
  4. The no-audio class

Pick post types to generate audio for

By default, TTSWP only generates audio for Posts. To enable audio for other content types, turn on their toggle.

Supported post types:

  • Posts (default on)
  • Pages
  • WooCommerce products
  • Custom post types registered by your theme or other plugins

When auto-generate on publish is on, only enabled post types get automatic audio.

Include the post title

When Include title in audio is on, the post title is read aloud first, then the content. This is the default.

Turn it off if:

  • Your title already appears inside the content (some themes do this)
  • You want the audio to jump straight to the article body

CSS selectors: include and exclude

Two fields, both optional.

Include selectors

By default TTSWP narrates the entire post content area. If your theme stores the main article inside a specific container (for example .article-body or #main-content), add that selector here. Only text inside matching elements will be narrated.

Leave this field empty to keep the default behavior.

Exclude selectors

Add any CSS selector whose text you want to skip. Matching elements (and everything inside them) are removed before audio is generated.

Common examples:

.wp-caption
figcaption
.sidebar
#secondary
.widget-area
.related-posts
.comments-area
#comments
.ad-container

You can add multiple selectors one per line.

The no-audio class

The easiest way to exclude a single block from audio is to add the no-audio class to it.

In the block editor:

  1. Click the block you want to exclude.
  2. Open the block sidebar on the right.
  3. Scroll to Advanced.
  4. Add no-audio to Additional CSS class(es).

In the classic editor or page builders:

<div class="no-audio">
  This text will not be included in the audio.
</div>

Works inside any page builder that respects class attributes (Elementor, Divi, Visual Composer, Gutenberg, classic editor).

Exclude posts from specific categories

This is not a setting on the Content page - it lives in the post editor.

  1. Open the post.
  2. Look for the TTS audio panel in the right sidebar.
  3. Check Skip audio for this post.

The post keeps its other content and category assignments, but TTSWP does not generate audio for it.

Order of filters

TTSWP processes your post in this order:

  1. Grab the raw post content
  2. Apply include selectors (if any)
  3. Remove elements matching exclude selectors
  4. Remove elements with the no-audio class
  5. Strip images, shortcodes, and scripts
  6. Clean up whitespace
  7. Send to ElevenLabs

If something unexpected still shows up in the audio, check steps 3 and 4 - your selectors or classes may not match.

Testing your filters

After changing filters, regenerate audio on a test post to hear the result:

  1. Open Posts → All Posts.
  2. Find the test post.
  3. In the TTS column, click Regenerate.
  4. Click Play to listen.

If the result is not what you expected, tweak selectors and try again. It is easier to fix on one post than across your whole site.