This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Projects by WooThemes


Create and display a portfolio of projects

“Projects” by WooThemes is a clean and easy-to-use portfolio showcase management system for WordPress. Load in your recent projects, and display them on a specified page using our template system, or via a shortcode, widget or template tag.

Projects integrates with our testimonials plugin allowing you to associate a testimonial with a project and display it on the single project page.

You can even assign a project to a product you’ve created in WooCommerce and let customers add it to their cart from the project page.

Easy to use

Publish and categorise your portfolio of projects using the familiar WordPress interface.

Detailed project information

Include full project details such as cover images, galleries, categories, client details and projects URLs.

Fully integrated with WordPress

Display your portfolio of projects using native WordPress architecture (project archives & single pages).

Widgets & Shortcodes included

Use Widgets & Shortcodes for situational project display.

Mobile friendly

Projects includes a responsive layout to integrate with any theme.


Get your hands dirty! Customise & extend Projects via a vast array of hooks, filters & templates.


Assign projects to products and give visitors an easy way to add products to their cart using WooCommerce functionality.


Integrated with our testimonials plugin allowing you to assign a client testimonial to a project and display it on the single project page.


Extensive documentation to help you out if you get stuck.


Once installed you can begin adding projects to your portfolio right away via the ‘Projects’ item in the main menu. But before you do that you should go ahead and create a page for your projects (via the Pages menu item) and specify that page as your projects base page in the projects settings. The interface for adding projects is very similar to adding posts so you should feel right at home.

For more detailed usage instructions take a look at the Projects Documentation.


  • The projects base page
  • A single project page
  • The projects management screen within the WordPress dashboard.


Installing “Projects” can be done either by searching for “Projects by WooThemes” via the “Plugins > Add New” screen in your WordPress dashboard, or by using the following steps:

  1. Download the plugin via
  2. Upload the ZIP file through the “Plugins > Add New > Upload” screen in your WordPress dashboard.
  3. Activate the plugin through the ‘Plugins’ menu in WordPress


Installation Instructions

Installing “Projects” can be done either by searching for “Projects by WooThemes” via the “Plugins > Add New” screen in your WordPress dashboard, or by using the following steps:

  1. Download the plugin via
  2. Upload the ZIP file through the “Plugins > Add New > Upload” screen in your WordPress dashboard.
  3. Activate the plugin through the ‘Plugins’ menu in WordPress
My project images are blurry / distorted, how do I fix that?

It’s possible that your theme is scaling images to fit their container by setting width: 100%;. If this is the case, and your project thumbnails are too small they will become distored / blurred as they are scaled up. To fix this change the project thumbnail size options in the Projects settings then regenerate your thumbnails using the Regenerate Thumbnails plugin.

How do I integrate projects into my theme?

If you run into layout issues on Projects pages then you will need to peruse one of two methods to make your theme compatible. You can read all about this in the documentation.

I want to change X

Projects uses template files to control the display of it’s various components. These templates can be safely editied so that your customisations are not lost during updates as described in the documentation.

Is it possible to add cusstom fields to the Project details meta box?

Yes! You can follow this tutorial to add custom fields to projects and display them.

How do I contribute?

We encourage everyone to contribute their ideas, thoughts and code snippets. This can be done by forking the repository over at GitHub.

Can I display a tesitmonial on a project page?

You sure can! Read about how in the documentation.


Tried to contact them for a week and no response... I am impressed with the disparity of goals and their ability to achieve. Not sure I would trust them with mission critical processes.
Read all 5 reviews

Contributors & Developers

“Projects by WooThemes” is open source software. The following people have contributed to this plugin.


“Projects by WooThemes” has been translated into 3 locales. Thank you to the translators for their contributions.

Translate “Projects by WooThemes” into your language.

Interested in development?

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



  • 2015.12.07
  • New/Fix – Adds query class to modify the query to fix the Project page not loading.


  • 2015.07.07
  • Tweak – Allow attribute for include_children inside taxonomy query.
  • Removes deprecated constructor call for WP_Widget


  • 2014.12.05
  • Fix – Redirect issue when setting projects page as homepage.


  • 2014-11-11
  • Fix – Project gallery thumbnail sizes in admin. (Props @corvannoorloos).
  • Fix – Undefined index notice when trashing/untrashing projects. (Props @johnbuck).
  • Tweak – Improvements to projects_template_redirect().
  • Tweak – Added rel="lightbox" to project galleries for compatibility with lightbox plugins.
  • Tweak – Project post type default url structure no longer includes project category (resolves attachment page 404’s.


  • 2014-08-26
  • New – Adds admin tabs to the settings screens for better UX.
  • New – Category permalinks use base page for structure.


  • 2014-06-06
  • Tweak – Product linking label now includes sku / id.
  • Tweak – Widgets now called via a single function and other minor refactoring.
  • Tweak – Project Category taxonomy names filterable. (Props @abouolia)
  • Fix – Reset post data in projects widget.


  • 2014-04-24
  • Fix – Javascript error in admin
  • Fix – Select box save method. (Props @anija).


  • 2014-04-09
  • New – Replaced .less files with .scss.
  • New – Integrated with WooCommerce.
  • New – Added config.codekit.
  • New – Project images can now be cropped. (Props @helgatheviking).
  • New – Project archive slug is now retreived from base page slug.
  • Tweak – Added css for multi column layouts when using the shortcode to display projects.
  • Tweak – Project categories can now be added to navigation menus.
  • Tweak – Various new input types can now be easily added using projects_custom_fields filter. (Props @helgatheviking).
  • Tweak – Menu icon added in register_post_type() and now filterable. (Props @helgatheviking).
  • Tweak – Added an edit media link to the project gallery meta box.


  • 2014-03-25
  • New – Integration with Testimonials plugin.
  • New – dummy_data.xml containing dummy projects content.
  • New – Project excerpt replaced with new short description meta box with tinymce support.
  • New – Projects can now be filtered by category on the project management screen.
  • Fix – Project category widget list items are now wrapped in a ul.
  • Tweak – Shortcodes in project descriptions now work as expected. Shortcodes in excerpts will need to be enabled.
  • Tweak – Gallery images link to full size versions. Disable with projects_gallery_link_images filter.
  • Tweak – Projects Post Type / Taxonomy args are now filterable. (Props @helgatheviking).
  • Tweak – Projects post type single/plural names are now filterable. (Props @helgatheviking).
  • Tweak – Several UI tweaks and improvements.
  • Tweak – It’s now possible to add select and radio custom fields using the projects_custom_fields filter (Props @helgatheviking).


  • 2014-02-24
  • Localization – Replaces incorrect language files.
  • Tweak – Localized some strings (props Vaclad)


  • 2014-02-17
  • Initial release. Woo!