Skip to main content
WordPress made easy with the drag & drop Total WordPress Theme!Learn More

bbPress Forums for WordPress: A Quick Guide

August 5, 2013
bbPress Forums for WordPress: A Quick Guide

Discussion forums have been around for almost as long as the internet itself. Even before the World Wide Web became popular, people were sharing information and discussing topics using terminal server bulletin board systems. In fact, my very first experiences with the Internet back in 1998 revolved around the chat rooms and discussion forums on AOL (boy do I look back nostalgically at those halcyon days).

The modern discussion forum retains the core idea of what is now a very well-established concept — sharing information and discussing topics — but has evolved into a lightweight plugin for WordPress that can be installed in a matter of minutes.

I am talking about bbPress – the WordPress forum software built by the very guys who created WordPress itself. In this post I am going to explain exactly what bbPress is, why you may need it, and also show you how to install it.

Why You Need bbPress

Total WordPress Theme & bbPress

The feature-set of bbPress is nowhere near as comprehensive as dedicated forum software such as phpBB or vBulletin, so why use it? There are a few compelling reasons why.

  1. It’s lightweight. Forum software is traditionally bloated, full of security holes, and a real drain on your server. The latest version of bbPress (v2.5.13) is simple to use and open source – so you can tweak the plugin as necessary.
  2. It’s fully integrated with WordPress. This benefit goes beyond the ease of installation. bbPress takes advantage of the WordPress user management system, and has access to the vast WordPress plugin repository, where you’ll find a decent number of specific bbPress compatible plugins. One of these is BuddyPress, a template for a WordPress-based social network that actually uses bbPress to power its forums.
  3. Customization is easy. bbPress has a unique advantage over other forum software when it comes to customizing the styling for your forum. Since it’s built for WordPress there are many amazing themes (like the Total WordPress Theme) designed specifically for bbPress so changing the look for your forum is as easy as changing your theme.

If you want to start a traditional bulletin board or new social network then bbPress probably isn’t for you (although do check out BuddyPress as a basis for the latter!)

However, if you want to add a community element to an existing blog or a support area for your clients, you’ll be hard-pressed to find something better suited than bbPress.

What Is bbPress?

Any site owner should understand what’s going on within their plugins. bbPress is simply three custom post types, some layout templates, a system of shortcodes, a couple of widgets, and CSS code. That’s why it’s called lightweight!

Custom post types

The three custom post types are:

  1. Forums: which holds each discussion forum you create, allowing a hierarchy of forums to be created
  2. Topics: which holds each discussion thread (the title and opening post)
  3. Replies: which holds each individual reply to a topic


The standard layout templates are suitable for most instances. For example, the topics layout will display a list of topics with the following information:

  • Topic name
  • Who started the topic and in which forum they started it
  • The number of people engaged in conversation (voices)
  • The number of replies to the topic
  • (And possibly) How long ago the last reply was and who made it

bbPress Topics Page

The various elements can be styled with CSS to better fit your blog, but if you want to make substantial changes to the structure, you’ll need to be comfortable with PHP or purchase a theme like Total that offers custom styling options built-in.

Shortcodes and Widgets

bbPress makes it simple to display the various elements of the forum wherever you want to through a series of shortcodes and widgets. This is actually an incredibly powerful feature, allowing you to consider usability and responsive design.

For example, you can create a page listing the latest topics with a selection of the most popular posts highlighted in your sidebar by using just one short code and one widget. If you decide you prefer a more traditional forum layout listing the categories, you can switch things around in minutes.

To give you a feel for the flexibility, check out the codex to view all 19 bbPress shortcodes.

The included widgets are:

  • Forums list
  • Recent replies
  • Recent topics
  • Topic views list
  • Search
  • Login widget
  • Statistics

The login widget is especially useful, displaying a login form to visitors, and a profile link to logged-in users.


If you decide to give bbPress a go, installation couldn’t be simpler.

Install bbPress via the WordPress Directory

Just search for bbPress in the WordPress plugin directory, hit install, and you’re done (or, if you want to use the plugin as a basis for development, or just to take a closer look, you can download a copy from the WordPress plugin repository).

bbPress WordPress Forums

Install bbPress via a WordPress Theme

Your other option is to install the plugin via your WordPress theme (if it offers the option). For example, the Total WordPress theme is not only fully compatible with bbPress but it includes a ready to go, easy import bbPress demo.

Install Total bbPress Demo

Simply head over to Themeforest and buy Total (one of the highest rated and popular drag & drop WordPress themes on the web), install & activate it, then navigate to Theme Panel > Demo Importer (note: this is unique to Total, most themes will not include this awesome and easy to use feature).

From here search for “bbpress” then click on the demo to begin.

Install bbPress Plugin

Once you click Total will prompt you to install any required plugins, which in this case includes bbPress. Simply click on each plugin to install and activate.

Import Total bbPress Content

With that done Total offers you the option to specify which parts of the demo you’d like to import. For the Total bbPress demo be sure all boxes for XML sample data, images, theme customizer settings and widgets are set to have your website looking identical to the live demo.

Total bbPress Demo Import Complete

When the import is complete you should see a message like the one above. This means your sample content and bbPress are ready to go!

Basic bbPress Setup

Once bbPress is installed and active, you’ll notice the three new custom post types in the admin menu, and a bbPress page in the Settings menu.

Before you dive in and create the forum of your dreams, spend some time in the settings menu. Navigate to Settings > Forums.

bbPress Spam Settings

In particular, you’ll want to tweak the spam settings, including:

  • Throttle Time: the minimum number of seconds allowed between new replies from the same user
  • Allow Anonymous Posting: Disable this to require a user to register for an account to post a topic or a reply

Once you’ve done this, it’s good to create a number of sample forums, topics, and replies (preferably from several different user accounts) before you start to tweak the design. With dummy data you’ll be more likely to spot things that need fixing with CSS, particularly on mobile devices. Lucky for you, if you’ve chosen to use the Total theme sample demo you’re all set to move on to customizations!

Customizing bbPress

To customize bbPress you really need to be a developer… or use one of the following cheater methods to customize your forum styling without knowing how to code.

Option 1: Use Your Theme Settings

First off, if you did decide to use a theme that offers added bbPress options you should look there first. Navigate to Appearance > Customize to edit options.

bbPress Live Customizer Options

Specifically under the bbPress section (like the one in Total) to select the default page layout for forums, topics and user pages. After that utilize settings under Typography for custom fonts and under General Theme Options for accent colors, Page Header Title selections, Forms styling, Links & Buttons customizations and more to make the design match your branding.

Option 2: Use a Live CSS Editor Plugin

If by chance your theme doesn’t offer any styling options, or simply not the ones you’re looking for you might want to consider a live CSS editor plugin. These plugins allow you to point, click and edit elements of your website using easy styling options (no code required). Here are our two favorites:

  • Yellow Pencil: This plugin is one of our favorites. Simply install and click “Let’s Start” to begin customizing your website! Want to learn more? Checkout our full Yellow Pencil user guide to see how the plugin works and what features are included.
  • CSShero: Similar to the previous plugin, CSShero offers a super easy to use point & click interface to edit styles, colors, fonts, spacing and more. Take a look at how this plugin works in our CSShero guide for customizing WordPress.

Recommended bbPress Add-on Plugins

As mentioned earlier, bbPress is easy to extend through a large number of plugins. Here are a handful we think you might like to consider to add more features and options to your forums.

Ultimate Member bbPress Addition

Add options for easy user signup, advanced profiles and even memberships with the Ultimate Member plugin. This extensible option fully integrates with bbPress so you can offer your forum members more to enjoy.

More about Ultimate Member →

bbp Style Pack

Want to add a few basic styling options for your bbPress forum? Give bbp Style Pack a try. This free plugin adds options to customize styling, links, display features and more.

More about bbp Style Pack →

bbPress Notify (No Spam)

This plugin sends an email notification to users when new topics and/or replies are posted. It’s useful if you’re operating a support forum and need a particular person to respond to questions in a particular forum, for example.

More About bbPress Notify →

GD bbPress Tools

One of the more comprehensive bbPress plugins available, this adds BBCode support, user signatures, additional custom views, in-reply quotes, plus some additional admin features.

More about GC bbPress Tools →

The Best Forum Solution?

It’s lightweight, quick, and easy to install, but is bbPress the best forum solution for your WordPress blog? There’s only one way to find out — grab a copy, install it on your site and start experimenting!

Now it’s time to get your feedback. Are you a bbPress user? Do you consider bbPress to be the best forum solution for WordPress users, or do you prefer an alternative solution? What’s your experience of adding a community element to your blog?

Please give us your answers to the above questions in the comments sections below. Alternatively, if you have any other comments or questions, please fire away!

Article by Tom Ewer guest author
Subscribe to the Newsletter

Get our latest news, tutorials, guides, tips & deals delivered to your inbox.


  1. L.L.

    How can you integrate social sharing buttons within the bbPress WordPress forum? I’ve tried everything I can think of, but the forum just won’t accept any coding nor any plugins for Social Network Sharing. Any ideas?

    • AJ Clarke | WPExplorer

      Hum…bbPress runs off a Standard WP installation so you shouldn’t have any issues. I’m sure there are plugins out there for doing what you want. If the code isn’t working or the plugins the only thing I can think of is the theme you are using is causing issues or your site is cached and you need to clear that.

  2. Paul

    Hello there? I was wondering whether any user in the forum can be able to reply via their own email and the same is posted to the forum

    • Tom Ewer

      I’m not 100% sure what you’re asking but I think the answer is yes 🙂

  3. gianni

    it’s possible to use another registration form instead of wordpress registration form?
    I would like to access the forum with credentials different from those of wordpress

    • AJ Clarke

      You’ll need to use a 3rd party plugin, I think Gravity Forms has a registration form option (but I think it requires the “Developer” license).

  4. Rob Mehew

    Nice article, I like the exposure bbPress seems to be gaining lately, I have created the bbPress starter theme which has helped quite a few people and I hope to update it in the future.

    One thing I would recommend to new people to bbPress is not to expect it to look perfect and how you think a forum should look, it takes some customisation, but try and think outside the box and don’t just go for a standard form 🙂

    Good luck!

    • Kyla

      That’s a great tip!

  5. David

    Very useful, although I’m struggling to get my templates working as I expected. Do you know if you can create templates using the WordPress naming conventions for CPT’s, ie: single-[my-custom-post-type].php which will automatically be used by WordPress… So I guess for bbPress it might be bbpress-[my-forum].php. Doesn’t seem to work for me…


    • AJ Clarke

      Yes, if you are trying to override the bbPress templates you will do so like that, however, I think a lot of the templates need to go inside a bbpress folder in your theme.

  6. heppu99heppu

    I have a problem getting “Enable threaded (nested) replies” to work. I’v read some solutions, but they are not working. Do You have it working?

    • AJ Clarke

      It’s possible the theme you are using isn’t setup correctly to display the threaded replies, have you tried a different theme?

  7. Aborisade Adekunle

    Thanks for the good job you are doing. I have installed bb press, which plugin do you think I should install so that when members read any topic, a particular amount will be given to them. And when it reach a particular amount, such user can request for it to be paid

    • Kyla

      I think that many of the top membership plugins allow you to show a preview for content. I’m not sure off the top of my head which are compatible with bbPress, but Restrict Content Pro is always a great place to start.

Leave a Reply

Your email address will not be published. Required fields are marked *

Learn how your comment data is processed by viewing our privacy policy here.