Filterable Portfolio


A WordPress Portfolio plugin to display portfolio/project images to your site.


  • Fully responsive
  • Portfolio Showcase with sorting images by groups.
  • Supported Browsers: Chrome, Firefox, Edge, IE 11, Safari
  • Two portfolio themes with css3 effect
  • Single portfolio page template
  • Slide of portfolio images on single portfolio page
  • Related Projects on single portfolio page
  • Setting page with many options
  • Custom Meta box for Project Images, Client Name, Project Date and Project URL


If you are using Gutenberg Block Editor (WordPress 5.0 or later), search ‘Filterable Portfolio’. There is
a dedicated ‘Filterable Portfolio’ block with live preview for Gutenberg Block Editor.

After installing and activating the plugin, a new custom post type called “Portfolios” will appear at your WordPress Admin area. Just create your Portfolio from the “Portfolios” menu & paste the following shortcode where you want to display this Portfolio:


The shortcode can include following attributes.

  • featured: Default value no. Value can be yes or no.
  • show_filter: Default value yes. Value can be yes or no.
  • filter_by: Default value categories. Value can be categories or skills.
  • theme: Default value one. Value can be one or two.
  • buttons_alignment: Default value center. Value can be start or center or end.

Example 1:

[filterable_portfolio featured='yes' show_filter='no']

Theme Integration

Filterable Portfolio works with most theme out of the box. But the following theme support its full features like single, archive and taxonomy template. Filterable Portfolio is fully integrated with the following themes.

  1. Shapla –


  1. Isotope
  2. tiny-slider


  • Screenshot of Theme one.
  • Screenshot of Theme two.
  • Filterable Portfolio in Gutenberg Block Editor.
  • List of portfolios in admin dashboard.
  • Filterable Portfolio settings.
  • Filterable Portfolio edit page.


This plugin provides 1 block.

  • Projects


Installing the plugins is just like installing other WordPress plugins. If you don’t know how to install plugins, please review the two options below:

Install by Search

  • From your WordPress dashboard go to Plugins > Add New.
  • Search for Filterable Portfolio in Search Plugins box.
  • Find the WordPress Plugin named Filterable Portfolio by Sayful Islam.
  • Click Install Now to install the Filterable Portfolio Plugin.
  • The plugin will begin to download and install.
  • Now just click Activate to activate the plugin.

If you still need help. visit WordPress codex


After changing portfolio slug, portfolio link is not working.

After change portfolio slug, you need to regenerate permalink.
To regenerate permalink, go to Settings –> Permalinks from WordPress admin and press on “Save Changes” button.

How to use Filterable Portfolio in Gutenberg Block Editor (WordPress 5.0 or later)

Filterable Portfolio is first class citizen in Gutenberg Block Editor. Just search ‘Filterable Portfolio’. There is
a dedicated ‘Filterable Portfolio’ block with live preview for Gutenberg Block Editor.

I want to remove Project Date. Is it possible?

You can add, remove or modify any field using filter hook. filterable_portfolio_meta_box_fields
Here is an example to remove Project Date.

function filterable_portfolio_remove_product_date( $fields ) {
    // Remove product date
    unset( $fields['_project_date'] );

    return $fields;
add_filter( 'filterable_portfolio_meta_box_fields', 'filterable_portfolio_remove_product_date' );

Here is a list of all default meta fields: _project_images, _client_name, _project_date, _project_url


December 13, 2020
Started using this plugin to display and sort vacation rental listings. Love how simple it is, I had a slight fix with maybe 6 lines of CSS to have the button overflow contain itself to the width of the display area but that was no big deal. I do wish we could customize the elements on the portfolio pages as “skills” and “date” are not actually relevant fields for what I am using it for – and that we could have a shortcode to search by the skills as well (we can only filter by categories at the moment). But so far loving the plugin! It is exactly what I needed and free, thank you so much for developing this
May 4, 2019
J’ai essayé plusieurs extensions toutes “gratuites” mais avec un thème par défaut très … austère. Je suis tombé sur cette extension qui correspond à mes besoins. Elle est gratuite et complète. On n’essaye pas de vous vendre des options. Certaines applications concurrentes sont “gratuites” mais vous ne pouvez vraiment rien faire. Celle-ci n’est pas de ces applications. Merci à vous ! (ps. : oui les développeurs doivent se rémunérer mais dans ce cas qu’ils les mettent payantes parce que c’est ridicule de mettre une application sans rien pouvoir faire) – I tried several extensions all “free” but with a very … austere default theme. I came across this extension that fits my needs. It’s free and complete. We’re not trying to sell you options. Some competing apps are “free” but you really can’t do anything. This one is not such apps. Thank you! (ps.: yes developers have to pay themselves but in this case they put them paid because it is ridiculous to put an application without being able to do anything)
February 7, 2019
This is a beautiful portfolio plugin. I love the clean design and layout as well as the custom post type, however, it’s not possible to get support so I’ve run into a few customization roadblocks with this plugin.
Read all 13 reviews

Contributors & Developers

“Filterable Portfolio” is open source software. The following people have contributed to this plugin.


“Filterable Portfolio” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Filterable Portfolio” into your language.

Interested in development?

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


version 1.6.4 – 2023-11-18

  • Dev – Check compatibility with WordPress 6.4
  • Fix – Block related issue.

version 1.6.3 – 2022-11-22

  • Add filter hook to load single portfolio template and archive portfolio template from plugin.
  • Add ‘orderby’ and ‘order’ shortcode and block attributes to change global option.

version 1.6.2 – 2022-09-23

  • Add default archive template for portfolio post type if it not exists in theme.
  • Add attribute to change filter option from ‘categories’ to ‘skills’.
  • Add setting option to disable single portfolio category and skill archive page link.

version 1.6.1 – 2022-07-22

  • Add responsive setting on block option.
  • Add block option to set maximum limit.
  • Fix PHP Deprecated notice when finding invert color.
  • Add background color on ‘Filterable Portfolio’ brand icon.
  • Fixed design issue related to box-sizing on default ‘Twenty Twenty-Two’ theme.

version 1.6.0 – 2022-07-17

  • Feature – Add block with options (toggle filter buttons, show only features projects, theme, filter buttons alignment and more)
  • Added – Add setting option to set project date as create datetime.
  • Added – Add two shortcode attribute ‘theme’ and ‘buttons_alignment’

version 1.5.2 – 2022-06-23

  • Added – Add setting option to set alignment for filter buttons.
  • Dev – Check compatibility with WordPress 6.0

version 1.5.1 – 2021-08-01

  • Dev – Add CLI command to add dummy data.
  • Dev – Check compatibility with WordPress 5.8
  • Fix – Fix ‘permission_callback’ php notice

version 1.5.0 – 2019-11-17

  • Dev – Upgrade isotope to version 3.0.6 and tiny-slider to version 2.9.2
  • Added – Add portfolios REST endpoint to get portfolios.
  • Added – Add categories and skills REST endpoint.
  • Added – Add “Featured” attribute on shortcode and REST api.
  • Tweak – Hide filter button if button quantity is one.
  • Added – Add image size for single portfolio project images.
  • Tweak – Removed alpha color picker for filter buttons.
  • Dev – Removed shuffle js library.
  • Dev – Update css inline style with css variable.
  • Dev – Update shortcode html structure and refactor core code.

version 1.4.0 – 2019-01-31

  • Added – Add support for Gutenberg editor introduced on WordPress 5.0
  • Added – Add CSS for Twenty Nineteen theme.
  • Dev – Check compatibility with WordPress 5.0
  • Dev – Update isotope to version 3.0.5
  • Dev – Update Shuffle to version 5.2.1
  • Dev – Update tiny-slider to version 2.9.1
  • Dev – Add Filterable_Portfolio_Helper PHP class

version 1.3.2 – 2018-05-11

  • Added – Add portfolio settings to change Portfolio Slug, Portfolio Category Slug, Portfolio Skill Slug.
  • Dev – Add filter hook filterable_portfolio_category_args for modifying portfolio_cat taxonomy arguments.
  • Dev – Add filter hook filterable_portfolio_skill_args for modifying portfolio_skill taxonomy arguments.
  • Dev – Update plugin core.

version 1.3.1 – 2017-12-09

  • Added – Add alpha color picker to choose button color.
  • Fixed – Fixed images overlapping issue.
  • Tweak – Upgrade Shuffle to version 5.0.3
  • Tweak – Upgrade Isotope to version 3.0.4
  • Tweak – Upgrade Tiny Slider to version 2.3.10
  • Dev – Load non-minified version when script debug is enabled.
  • Dev – Update plugin core.

version 1.3.0 – 2017-10-12

  • Update – Update plugin core
  • Tweak – Replace ResponsiveSlides with tiny-slider
  • Tweak – Combine public facing custom scripts to one file

version 1.2.2 – 2017-06-22

  • Updated – Removed jQuery dependency for isotope and rewrite with vanilla JS.

version 1.2.1 – 2017-03-27

  • Added – New Filterable Portfolio Widget to add portfolio at widget. Especially helpful for page builder that use widget like “Page Builder by SiteOrigin” or “Elementor Page Builder”.
  • Added – Added archive, taxonomy, and single portfolio template for Shapla Theme.

version 1.2.0 – 2017-03-21

  • Added – Added option to choose filter script from Shuffle or Isotope

version 1.1.2 – 2017-03-20

  • Fixed – Fixed “headers already sent” notice on plugin activation
  • Added – Added portfolio_skill taxonomy
  • Added – Added options to change meta label on portfolio single page

version 1.1.1 – 2017-03-13

  • Updated – To make portfolio_cat taxonomy hierarchical like categories
  • Added – Added ‘custom-fields’ support on portfolio post type
  • Added – Added option to customize shortcode from theme using ‘filterable_portfolio.php’ file
  • Added – Added option to set order, orderby and posts per page

version 1.1.0

  • Updated – Upgraded shuffle javaScript to version 4.0.2
  • Removed – prettyPhoto, fontawesome and modernizr
  • Added – Added Project Images, Client Name, Project Date and Project URL.
  • Added – Setting page with many sitting options.
  • Added – Two Portfolio Theme.
  • Added – Single page template.
  • Added – Slide of images on single page.
  • Added – Related Projects on single page.

version 1.0.1

  • Added support for comment on portfolio single post.

version 1.0.0

  • Implementation of basic functionality.