Skip to content
PinnedSolvedDevelopment

How to customise bbPress templates in a child theme?

Started by Maria Costa · 2 days ago#bbpress#templates

Replies
48
Voices
6
Views
3.2k
Last activity
2 min ago
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

Reply to: How to customise bbPress templates in a child theme?

Preview

You must be logged in to reply to this topic.