BuddyX
Get BuddyX Pro

Reading Time

Pro feature

Show an estimated "X min read" label in the post meta row so visitors know how long an article will take before they start. BuddyX Pro calculates the estimate for you from the post content - there is nothing to type in per post. The feature is a single on/off switch and ships off by default, so existing single-post views render unchanged until you turn it on.

Turning On Reading Time

  1. Go to Appearance > Customize
  2. Click on Blog
  3. Find the Single Post Settings section
  4. Set Show reading time to Yes
  5. Click Publish

Setting: Show reading time (single_post_reading_time) Default: No (off) Options: Yes / No

Tip: The customizer tooltip sums it up - "Append an estimated reading time (assumes 200 words per minute) to the post meta row." Enable it, then open any published post to confirm the label appears.

How the Estimate Is Calculated

BuddyX Pro works out the reading time automatically. You do not set a value per post - the theme reads the published content and does the math on every page load.

  • Baseline speed: 200 words per minute, the standard editorial reading pace.
  • What gets counted: The post body only. The theme strips shortcodes and HTML tags before counting words, so embedded YouTube, Instagram, and other media blocks do not inflate the number.
  • Rounding: The word count is divided by 200 and rounded up to the next whole minute. A 150-word post still reads as "1 min read".
  • Minimum: The estimate never drops below 1 minute, so even a one-line post shows a sensible label.
Post length Calculation Label shown
150 words 150 / 200, rounded up 1 min read
600 words 600 / 200 3 min read
1,400 words 1,400 / 200 7 min read
3,000 words 3,000 / 200 15 min read

The label is translation-ready and uses the singular/plural form for the minute count, so it reads correctly in every language you run the theme in.

Where It Appears

The reading-time label renders on single post views only - the full-article page a visitor lands on after clicking through. It is added to the end of the entry meta row, alongside the date, author, and category links.

It does not appear on:

  • Blog archive / listing pages (see Blog Archive Layout)
  • Pages, custom post types, or BuddyPress activity
  • Post excerpts or related-post cards

This keeps archives clean while giving readers the time estimate exactly where they decide whether to commit to the full read.

For Developers

Two hooks let you adapt the estimate without editing theme files:

  • buddyxpro_reading_time_minutes - a filter on the calculated minute value. Use it to assume a different reading speed, or to add padding for media-heavy posts. It receives the minutes (int) and the WP_Post object.
  • buddyx_entry_meta_after - the action the label is hooked onto. If you build a child theme, you can reposition or restyle the output from here.

The rendered label carries the classes posted-on bx-reading-time, so you can target it with custom CSS in Appearance > Customize > Additional CSS - for example to add an icon or change its color. Reading time inherits your active Site Skin and typography, so it matches the rest of the meta row in both light and dark mode automatically.

When to Use It

Turn it on for:

  • Long-form guides, tutorials, and how-tos where the time commitment matters
  • Magazine, news, and editorial blogs where readers scan before committing
  • Any content library where "quick read vs. deep dive" helps visitors choose

Consider leaving it off for:

  • Very short posts or link posts where "1 min read" adds little
  • Minimalist, distraction-free layouts where you want the meta row bare

Reading time pairs naturally with the Table of Contents and reading progress bar - together they signal up front how long and how structured a post is, which is exactly what long-form readers look for.

Related Settings

  • Post Elements & Meta - Choose which meta details (date, author, category) sit in the row next to reading time
  • Single Post Layout - Title layouts, content width, table of contents, and reading progress bar
  • Blog Archive Layout - Configure the blog listing pages where reading time does not appear

Got a question? We're a friendly team - happy to help.