Skip to content
PinnedSolvedClosedDevelopment

How to customise bbPress templates in a child theme?

Started by Maria Costa · 2 days ago

This topic is closed to new replies.A moderator closed this topic on Oct 21, 2026. You can still read it and mark helpful replies.
Back to the forum
Maria Costa
HelperTopic starter
Oct 19, 2026 at 10:12#1

I am building a child theme and want to override the default bbPress templates (forum list, single topic and reply form) without touching the plugin files.

What is the cleanest way to do this? I tried copying files into /bbpress/ in my child theme but nothing changes.

screenshot-1.png · 148 KB
Reply
Sara Lindt
Expert
Oct 19, 2026 at 10:48#2

The plugin looks for templates in a stack, and your child theme comes first as long as the folder is named bbpress (all lowercase) at the root of the child theme — not inside a subfolder.

Also double-check that the file names match exactly, e.g. content-single-topic.php.

Reply
Marked as the solution
Tom Becker
Expert
Oct 19, 2026 at 11:30#3

If you want full control, hook into the template stack and put your own directory first. That also lets you keep everything in one shared theme folder.

add_filter( 'bbp_get_template_stack', function ( $stack ) {
    array_unshift( $stack, get_stylesheet_directory() . '/bbpress' );
    return $stack;
} );
Reply
Maria Costa
Helper
Oct 19, 2026 at 12:05#4
Sara Lindt said:
The plugin looks for templates in a stack…

That worked, thank you both! The folder name was the problem — I had bbPress with a capital P.

Reply
Dan Okafor
Moderator
Oct 20, 2026 at 09:14#5

Nice catch. For anyone finding this later: also flush permalinks after adding new template files, and clear any page cache. 👍

Reply

Replies are disabled

Want to continue the discussion? Start a new topic.