GD bbPress Attachments


Attachments for forum topics and replies are handled through WordPress media library. You can control file sizes from the main plugin settings panel, or you can do it individually for each forum you have set. You can limit the number of files user can attach for each topic and reply. The plugin can embed a list of attached files into topics and replies, and images can be displayed as thumbnails. All upload errors are logged and topic/reply author and administrators can see those errors.

On the admin side, topic and reply panels have a column with attachments count, and on the individual edit pages you will see meta box with the list of attachments and upload errors.

Supported languages: English, Serbian, Swedish, Polish, Dutch, German, Italian, Slovak, French, Spanish, Persian, Portuguese.

bbPress Plugin Versions

GD bbPress Attachments 2.5 supports bbPress 2.5 or newer. Older bbPress are no longer supported!

BuddyPress Support

GD bbPress Attachments 2.5 is tested with BuddyPress 2.6 and newer and it works fine if you enable BuddyPress support in bbPress plugin for Group Forums. Make sure you enable JavaScript and CSS Settings Always Include option in the Attachments plugin settings.

Upgrade to GD bbPress Toolbox Pro

Pro version contains many more useful features 10 more BBCodes (including Hide and Spoiler), BBCodes editor toolbar, report topics and replies, SEO features, many more views, notification email control, BBCodes toolbar, great new responsive admin UI, enhanced attachments features and additional widgets. For more information: GD bbPress Toolbox Pro

Premium plugins for bbPress

More free plugins for bbPress


  • English
  • Serbian
  • Swedish:
  • Russian: Pavel Kuznetsov –
  • German: David Decker –
  • Slovak: Branco Radenovich –
  • French: Marie Bodson –
  • Polish:Daniel Napora –
  • Dutch: Wouter van Vliet –
  • Spanish: Jhonathan Arroyo –
  • Persian: Ramin Firooz –
  • Portuguese
  • Italian


  • Main plugins settings panel
  • Reply with attachments and file type icons
  • Image attachments with upload errors
  • Attachments with delete and detach actions
  • Attachments upload elements in the form
  • Single forum meta box with settings
  • Icons for the forums with attachments
  • Thumbnails displayed in line


General Requirements

  • PHP: 5.3 or newer

WordPress Requirements

  • WordPress: 4.2 or newer

bbPress Requirements

  • bbPress Plugin: 2.5 or newer

Basic Installation

  • Plugin folder in the WordPress plugins folder must be gd-bbpress-attachments
  • Upload folder gd-bbpress-attachments to the /wp-content/plugins/ directory
  • Activate the plugin through the ‘Plugins’ menu in WordPress


  • Where can I configure the plugin?
    Open the Forums menu, and you will see Attachments item there. This will open a panel with global plugin settings.

  • What are the common problems that can prevent upload to work?
    In some cases, it can happen that jQuery is not included on the page, even so, the bbPress requires it to be loaded. That can happen if something else is unloading jQuery. If the jQuery is not present, the upload will not work.
    Another common issue is that WordPress Media Library upload is not working. If that is not set up, attachments upload can’t work.

  • Why is Media Library required?
    All attachments uploads are handled by the WordPress Media Library, and plugin uses native WordPress upload functions. When the file is uploaded it will be available through Media Library. Consult WordPress documentation about Media Library requirements.

  • Will this plugin work with standalone bbPress installation?
    No. This plugin requires the plugin versions of bbPress 2.3 or higher.

  • Does this plugin work with bbPress that is part of BuddyPress plugin?
    No. Plugin requires bbPress 2.3 or higher plugin.

  • Does this plugin work with bbPress plugin used as sitewide forums for BuddyPress plugin?
    Yes. But, make sure to enable ‘Always Include’ option for JavaScript and CSS.

Installation Instructions

General Requirements

  • PHP: 5.3 or newer

WordPress Requirements

  • WordPress: 4.2 or newer

bbPress Requirements

  • bbPress Plugin: 2.5 or newer

Basic Installation

  • Plugin folder in the WordPress plugins folder must be gd-bbpress-attachments
  • Upload folder gd-bbpress-attachments to the /wp-content/plugins/ directory
  • Activate the plugin through the ‘Plugins’ menu in WordPress


just tried to install – error message "Plugin does not have a vild header"

Just tried to install and received a “This plugin does not have a valid header” so the plugin does not activate. Deleted.


Note: If you install this plugin via “Add New Plugin” through the backend, this is where the error message was displayed. I deleted plugin, downloaded .zip and installed manually. Works fine now!

Nice attachment system for bbPress

Works as intended. Bonus points for using the file types defined as valid WP media types. Only (small) nitpick is that it comes with its own styling for attachments, but they can be overridden in a user stylesheet (which is what I’m doing).

Read all 18 reviews

Contributors & Developers

“GD bbPress Attachments” is open source software. The following people have contributed to this plugin.


“GD bbPress Attachments” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “GD bbPress Attachments” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Updated JS and CSS files are by default always loaded
  • Updated WordPress minimal requirement to 4.2
  • Updated several broken URL’s
  • Updated and improved readme file


  • Added download attribute to attached files links
  • Updated sanitation of the plugin settings on save
  • Updated PHP minimal requirement to 5.3
  • Updated WordPress minimal requirement to 4.0
  • Updated several broken URL’s
  • Updated several missing translation strings


  • Added Swedish translation
  • Updated readme file


  • Added Russian translation
  • Updated readme file


  • Updated several Dev4Press links
  • Fixed XSS and LFI security issues with unsanitized input
  • Fixed order of displayed attachments to match upload order
  • Fixed inline image alignment when there is no image caption


  • Fixed problem with uploading video or audio files in some cases


  • Improved default styling for the list of attachments
  • Removed support for bbPress 2.2.x
  • Fixed posts deletion problem caused by attachments module


  • Improved default styling for the list of attachments
  • Removed obsolete hooks and functions
  • Removed support for bbPress 2.1.x
  • Fixed method for adding some of the plugin hooks
  • Fixed issue with attachments DIV not closed properly
  • Fixed few typos and missing translation strings


  • Added Slovak translation
  • Changed upload field location to end of the form
  • Dropped support for bbPress 2.0
  • Dropped support for WordPress 3.2
  • Fixed problem with saving some settings


  • Fixed detection of bbPress 2.2
  • Fixed missing function fatal error


  • Added support for dynamic roles from bbPress 2.2
  • Added class to attachments elements in the topic/reply forms
  • Using enqueue scripts and styles to load files on frontend
  • Admin menu now uses ‘activate_plugins’ capability by default
  • Screenshots removed from plugin and added into assets directory
  • Fixed problem with some themes and embedding of JavaScript
  • Fixed issues with some themes and displaying attachments


  • Additional settings information
  • BuddyPress with site wide bbPress supported
  • Expanded list of FAQ entries
  • Panel for upgrade to GD bbPress Toolbox
  • Fixed duplicated registration for reply embed filter


  • Added Italian translation
  • Updated several translations


  • Added Portuguese translation


  • Adding meta field to identify file as attachment
  • Few minor issues with plugin settings


  • Added option to display thumbnails in line
  • Added Persian translation
  • Improvements for the bbPress 2.1 compatibility
  • Several embedding styling improvements
  • Fixed some loading issues for admin side


  • Changes to readme.txt file
  • Improvements to the shared code


  • Additional loading optimization
  • Added French language
  • Updated some translations
  • Fixed minor issues with saving settings


  • Missing license.txt file


  • Added option for improved embedding of JS and CSS code
  • Minor changes to the plugins admin interface panels
  • Updated and expanded plugin FAQ and requirements


  • Loading optimization with separate admin and front end code
  • Added options for deleting and detaching attachments
  • Added several new filters for additional plugin control
  • Added option for error logging visibility for moderators
  • Fixed logging of multiple upload errors
  • Fixed several issues with displaying upload errors


  • Added hide attachments from visitors option
  • Added option to hook in topic and reply deletion
  • Added Polish translation
  • Improved adding of plugin styling and JavaScript
  • Fixed visibility of meta settings for non admins


  • Context Help for WordPress 3.3


  • Rel attribute allows use of topic or reply ID
  • Admin topic and reply editor list of errors
  • Updated German and Serbian translations
  • Updated readme file with error logging information


  • Fixed logging of empty error messages


  • Improved tabbed admin interface
  • Image attachments display and styling
  • Error logging displayed to admin and author
  • Fixed upload from edit topic and reply
  • Fixed including of jQuery into header
  • Fixed bbPress detection for edit pages


  • Improved Dutch Translation
  • Updated Frequently Asked Questions


  • Minor change to user roles detection
  • Fixed problem with displaying attachments to visitors


  • Spanish Translation


  • German Translation
  • Check for the bbPress to add JavaScript and CSS


  • Disable attachments for individual forums
  • Improved admin side topic and reply editor integration


  • Attachments icons in the attachment lists


  • Attachment icon of forums


  • Serbian Translation
  • Dutch Translation


  • Improvements to the main settings panel
  • Fixed missing variable for topic attachments saving
  • Fixed ignoring selected roles to display upload form elements
  • Fixed upgrading plugin settings process
  • Fixed few more undefined variables warnings