Menu Search
Jump to the content X X
Smashing Conf Barcelona

You know, we use ad-blockers as well. We gotta keep those servers running though. Did you know that we publish useful books and run friendly conferences — crafted for pros like yourself? E.g. our upcoming SmashingConf Barcelona, dedicated to smart front-end techniques and design patterns.

Getting Started With bbPress

Forums have been around forever, so it should come as no surprise that several plugins for the popular publishing platform WordPress provide this feature, as well as support for integrating other forum software. One project, however, has a special place in the WordPress community, and that is bbPress.

This is the software created by WordPress founder, Matt Mullenweg, as a lightweight system for the support forums. In true open-source fashion, the bbPress project was born (at bbpress.org1, of course) as a lightweight standalone alternative for forums.


The problem is that the project never really kept up the pace; and while the WordPress community wanted to use it, and bbPress saw some promising spurts of development, it never really caught up to the alternatives. Most of us who needed a forum went either with a plugin alternative that integrated perfectly or with forum software such as Vanilla3.

Further Reading on SmashingMag: Link

The Facebook-inspired community plugin BuddyPress8 changed all that. BuddyPress, which adds groups and other membership functionality to a blog, started to ship with bbPress integrated in it. Perhaps unknowingly, some WordPress bloggers who had community features powered by BuddyPress were actually running a version of bbPress, which is enabled in the BuddyPress interface. It worked — and continues to work — great actually; because although bbPress, as standalone forum software, is way behind the competition in terms of features, sometimes all you need is a lightweight alternative, which was the idea behind bbPress all along.

bbPress 2.0 changed it all again, because bbPress has now been officially reborn as a plugin for WordPress, something that had been in the works for quite some time. This is where we stand today, with a fresh release of the first version of the bbPress plugin. In the coming weeks (or right now, depending on when you’re reading this), the plugin will get proper documentation and more support for cool functionality. That shouldn’t stop you from giving it a go right away, because getting started and taking advantage of its core functionality is easy enough.

Before we move on, we need to clear up some nomenclature:

  • bbPress is a plugin for WordPress, and is sometimes referred to as bbPress 2.0 for clarity.
  • bbPress 1.0 is a standalone forum that integrates with WordPress (and the BuddyPress plugin) but does not reside in WordPress’ core.
  • BuddyPress is a separate plugin for WordPress that integrates with the bbPress plugin.
  • BuddyPress still ships with bbPress, but you can connect to your bbPress plugin forums if you want to.

Yes, it’s all a bit messy.

Getting bbPress Up And Running Link

Installing bbPress is easy, because it’s available in WordPress’ plugin directory9. Either install it from within WordPress, using the “Add new plugin” feature, or via FTP if you prefer to (or must) upload plugins. Then, activate the plugin, and you’re all set!

Well, not quite. You’ll want to look at some settings before starting to use the forums.

bbPress settings.

You’ll notice a new “Forums” menu under “Settings” in the admin area, along with the brand new sections “Forums,” “Topics” and “Replies,” all sporting bee-inspired icons.

Let’s look at the “Forums” settings pane first, shown above. Here you have an assortment of settings for your forums, such as whether to allow anonymous posts, how long posters should be able to edit their posts, and how many topics to show per page.

The “Archive” and “Single Slugs” settings are important. These define the URLs of your forums, the posts, and the tags for posts. Choose something that fits your set-up; if you’re running an English-language website, then the default settings will probably do, but you can fine tune to your needs. Remember to go to Settings → Permalinks after making any change to the slugs, and rebuild the permalink structure by clicking the “Save Changes” button on that page. If you ever have problems viewing the forums, give this a shot because it might be an issue with the permalinks, and rebuilding them might help. Also, make sure to press the “Save” button in Settings → Forums.

Where are your forums, then? Well, you’ll already know that from the Settings → Forums page, because they are located at the base slug assigned for the forums. By default, it would be forums, so you’d find them at Do yourself a favor and use pretty permalinks, because although bbPress will work without them, the URLs will look so much better if they’re pretty. That Google will thank you is just a bonus (note: an actual thank-you from Google is not guaranteed).

The forums page, without any forums unfortunately.

There we go: all set up and ready to go. Too bad there aren’t any forums, nor posts… yet!

Managing bbPress Forums Link

Getting bbPress set up and ready to go is a breeze, but if you actually want some action in your brand new forums, then you’ll need to create a forum. This is easily done under “Forums” in the admin area. Just click “New Forum,” and you’ll get a familiar-looking screen to create a forum.

Create a forum.

This is pretty self-explanatory. The one thing you’ll need to be careful with is the box in the top-right corner. These are the settings that enable you to control whether a forum is open or closed, whether it is a forum or a category, and who should see it. When you have created multiple forums, the “Parent” and “Order” options will show up, allowing you to nest forums (much like “Pages”) and sort them (also like Pages).

To make a long story short, with a few forums created, users will soon be able to post in your forums. Depending on your settings, they may need to sign up, but that’s a different matter and depends on what kind of website you’re running.

A forums page.

Managing “topics,” which are new posts, and “replies,” which are replies to topics, is easy enough. These show up under their respective sections in the WordPress admin area, and they behave much like posts and comments. That’s no surprise because bbPress has the same model as standard posts and Pages, using custom post types. This will also make it easy to style the bbPress forum should you want to, something we’ll look at more closely later.

Finally, one thing to know when running bbPress on a non-English website: localization projects are on GlotPress, and you can get a translation by using the options at the bottom of the entry for your selected language. You’ll need to upload these to the wp-content/plugins/bbpress/bbp-languages/ folder, and the file should be called, where sv_SE should be swapped for your language of choice. Hopefully, we’ll be able to store these files in the wp-content/languages/ folder later, but this doesn’t work for me right now.

Extending bbPress Link

Although bbPress is now a WordPress plugin and not a standalone system, you’ll find plugins that extend its functionality. Quite a few actually: for displaying the latest posts in widgets, adding signatures and whatnot.

Your starting point for bbPress-related plugins is the plugins section of the bbPress website10 and, of course, the WordPress plugin directory (begin with a search11).

One thing, though: make sure any plugin you choose is made for bbPress 2.0 (i.e. the plugin version). Older plugins made for the 1.x branch will not work.

BuddyPress And bbPress Link

BuddyPress, the plugin that enables you to create your own Facebook-like community on a WordPress website, work just great with bbPress. That should come as no surprise because the plugin still ships with the forum component (bbPress) built in. But this forum component is for enabling forums for your BuddyPress groups. Groups are exactly what they sound like: members can join them, even create their own (depending on your settings), and discuss various topics in them. With forums enabled for groups, every group will get a forum. This is still true with BuddyPress 1.5, despite there being a standalone bbPress plugin now. If you want forums for your BuddyPress-powered groups, then either choose an existing bbPress installation or install one in the BuddyPress settings. And yes, this is a bit confusing.

The settings page for BuddyPress forums.

With bbPress 2.0 and the shift from standalone forum software to WordPress plugin, you can rest assured that BuddyPress and bbPress still work well enough together. The option for installing forums site-wide is on the settings page for the BuddyPress forum, and it actually installs the bbPress plugin, rather than rely on the built-in forum component in the BuddyPress plugin. BuddyPress and the bbPress plugin integrate nicely out of the box, but not for group forums. Instead, your posts in the forums will show up in the BuddyPress activity stream; surely we’ll see some cool plugins in the future that leverage both BuddyPress and the bbPress plugin, tying the two even closer together.

All in all, there is no reason not to combine bbPress with BuddyPress if you need more community features than just a forum on your website.

Making bbPress Look Good Link

While your forums will work well out of the box, as you no doubt have gathered from the screenshots earlier in this article, you might want to make bbPress better suit the look of your website. You’ve already seen the default styles of bbPress, which you can tweak easily enough: just add CSS to your theme’s style sheet!

Doing this is easy: just inspect the code of the forums with your favorite Web inspector (such as Firebug12 or the built-in inspector in Chrome or Safari), and find the classes that you’ll need to style the forums.

The ul.bbp-forums class gives you control.

If you want more control, perhaps to break from the default layout of the forums, you can add additional template files to your WordPress theme. The bbPress plugin is already compatible with Twenty Ten13, the previous default theme. In the bbpress folder, look at the files in bbp-themes/bbp-twentyten/ and you’ll get an idea what you can do. Simply changing the theme to Twenty Ten (instead of Twenty Eleven, which was shown earlier in this article) will give us something different and more attuned to our theme.

We get a different look when using Twenty Ten.

How you style the forums will depend on how much you want to deviate from the default look and feel. If everything is where it should be, then you’ll be able to make the forums looks good and fit your theme just by adding styles to your theme’s style sheet. But if you want to move things around a lot, then you’ll probably have to create your own template files. Consult the files in the bbpress/bbp-themes/bbp-twentyten/ folder to get an idea of what can be done, while we wait for bbPress to publish proper documentation. Because forums are really just a custom post type, you’ll likely be able to find your way around if you’ve worked with them before.

Three Websites That Use bbPress Link

Want to see some bbPress forums in action, other than itself or Twenty Ten and Twenty Eleven themes with the plugin activated? Link

WordPress Forums14

While using bbPress on might not exactly qualify as eating one’s own dog food, this is where it started after all.

Dropbox Link

Dropbox Forums15

The syncing service Dropbox has been using bbPress forums for quite some time, with a pretty simple, standard look. This is just the standalone version, and it shows that bbPress is ready for prime time.

WPCandy Link

Discussions on WPCandy16

The forums section of WPCandy is a great example of how bbPress can be easily integrated in an existing WordPress theme.

What’s Next? Link

Personally, I’m thrilled to see bbPress become a WordPress plugin. We’ve seen plugins that add forum features to WordPress in the past, but I haven’t been comfortable running any of them, to be honest. Whenever I’ve needed forums, I’ve used software such as the excellent Vanilla. Some people have suggested the BuddyPress plugin, but that’s a bit much if all you need is a simple forum for discussions.

With bbPress 2.0, this isn’t an issue anymore, and although documentation isn’t available yet, getting started is easy enough. You’ll probably want to add features to your forums, and that’s easy with additional plugins. And because bbPress is really just a custom post type for your WordPress website, using actual registered users, you can use existing plugins to achieve things such as moderator privileges and whatnot. We can anticipate a boom of bbPress-compatible plugins in the near future that will make our forums even better and more interesting.

For now, let’s play with what we have, which is usually more than enough.


Footnotes Link

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
  15. 15
  16. 16

↑ Back to top Tweet itShare on Facebook

Thord Daniel Hedengren is addicted to words, which is probably why he keep writing books and never shuts up about writing. He is a contributor to numerous magazines and sites, as well as the owner of the Odd Alice web agency in Stockholm. You should follow this crazy Sweden on Twitter where he mixes wisdom with nonsense and the occasional jab as @tdh.

  1. 1

    lol! Read the ad wrong, though it said “love us black guys” instead of “love us back guys”. bbPress looks pretty neat though :)

  2. 2

    Don’t forget about my Twenty Eleven child theme update ;-)

  3. 3

    Aurélien Denis

    November 16, 2011 7:28 am

    For French readers, have a look at my podcast / how-to for bbPress 2.0 :

    This new version is really esay to use and totally integrated with WordPress !

  4. 4

    I have a bbpress 1.0 installed in a website that I manage. Is easy integrate bbpress 2.0 saving all the forums and posts, (the user database is the same)?? I don’t find a reference to this in the article. It would be great!

    (sorry if my english is not good)

    • 5

      bbPress the plugin comes with an importer for the older 1.x branch. I haven’t used it yet but since I’m looking at moving an older forum to the new version I’ve done some research and it seems to work totally fine most of the time.

      As always it’s advisable to run a test environment and test the conversion before actually doing it, just in case.

  5. 6

    This is as clear as mud. No, wait! It’s perfectly clear. Except it isn’t. Wait! There’s more! Let us explain the explanation. Wait! That’s confusing. But it’s easy!

    Good lord.

  6. 7

    I like bbPress because of its simplicity. Of course, it doesn’t suit on all situations, but I particularly think that myBB or phpBB (or even InvisionPB) are over killer for the most of the websites I’ve seen.

    But one article that I would love to see here is a deep dive on BuddyPress. Powerful, open-source but yet complicated to see all the possibilities in a first glance.

    Hope we have a deep dive on it soon, showing hacks and hidden gems behind it :)

  7. 8

    I’ve been using bbPress in my latest project, and I find it very easy to setup and customize

  8. 9

    Nice, I am motivated to use BBPress after reading this article

  9. 10

    This doesn’t look near as complex as I thought it was…. I think I’ll load it up on a practice site and take a look.

  10. 11

    Good to see that Buddypress and bbPress gets some attention. I would like to se some more indepth articles.

  11. 12

    What if i have a premium theme? can i use the bbpress twenty ten theme?

  12. 13

    Thanx for your great post!
    I’ve made a little plugin which adds some useful links and resources for bbPress 2.x to the WP Admin Bar – also very handy for forum admins/moderators:
    “bbPress Admin Bar Addition”

    -Thanx, Dave :)

    • 14

      Can you give me some websites that were created with bbpress alone garnished with other plugins?
      I have a wordpress site but I am looking for a software that more like a forum where users post their own articles. I am looking for a platform where users activities are shown in the home page, just like facebook.


  13. 15

    A great forum plugin not mentioned is SimplePress. I realize this is a bbpress article, but with forums being mentioned that do or don’t have features, SP is one that fits in the category of “does”. (Sounds like a Droid ad.) SP is a forum I used for a client project, and it’s tantamount to vBulletin in its feature-set. Great functionality and worth checking out. (No, I don’t work for them.) Good documentation, frequently updated, and they’re support forum is always tended to.

  14. 16

    A great walk-through. I have no doubt that bbPress is still the best forum solution for WordPress out there.

  15. 17

    Hi, there!

    Can someone help??? Languages!!!
    So, I have stand alone 1.0 bbPRESS and would like to add Slovenian language to it. I’ve created

    and copy translation in it and nothing. I’ve also downloaded and instaled bbPress Language Switcher, and doens’t work. I would be most gratefull for an advice since that is driving me nuts!

    Thank you,

    Mateja, Slovenia

  16. 18

    Hi guys,

    I work with WordPress and bbPress. Let’s set up a time to discuss


  17. 19

    Whilst I want to integrate BBpress to WordPress, I don’t want to run BBpress on the same WordPress database, having said that I still want to allow my registered users to connect to it. Can this be achievable?

    I can imagine my database filling up pretty quickly with hundreds of thousands of messages, so is there anyway to split them? but still have the users from the main wp site connect to the bbpress database.

    Perhaps some sort of “Sync” feature, those members who want to access the forums, will trigger a function that syncs the account with bbpress or something, or make bbpress fetch the auth details from main wp site.

    Anyone with me?

  18. 20

    I read a load of reviews and opinions on several blogs and forums about the top forum CMSs out there. I tried MyBB, Vanilla and BBPress. Finally settled with BBPress. MyBB was very old school, it can work for you if you just want a free legacy forum script. Vanilla had a lot of bugs when I tried to run it on my Windows Server 2008. Finally I settled with BBPress. A lot of features, like social login, notifications, attachments could only be accomplished by using plugins from the WP plugin repository. One will be surprised to know that even ‘signatures’ can only be implemented by means of plugins.

    Anyway, every things seems to work fine. I am currently in the process of tweaking the forum for SEO (one more reason why I chose BBPress). If everything works good, I am planning to roll out couple more forums.

    I would really appreciate your feedback on my BBPress forum.

  19. 21

    This was probably the worst walkthrough about bbpress I’ve read.

  20. 22

    Nowadays innovative thinking of a person will make them to goes up in the competitive world. Example in mobile world , new apps in iphone, android and windows . Developing many apps day by day means surely they should have the capacity to do it. Many Development companies like SJS and pacewisdom are play around their innovative things with the society like games apps and social media apps,etc. So Guys try to implement your best innovative things with the competitive world. Because this is the step to get your success quickly in the technology.

  21. 23

    I have integrated bbpress into my website and I have this problem, users who are signing up cannot receive the confirmation email, is there a way to fix that, thnks


↑ Back to top