Portfolio Press

Portfolio Press is a responsive WordPress theme for showcasing your photography, art, web sites, or other projects. It also works nicely as a regular blog site. An options panel is available for uploading logos and changing the layout. There’s also support for various post formats and menus.

Here’s a video screencast of how it works:

Download It | Demo It

The theme is in the WordPress Themes Directory. You can demo it here. Or download a copy and try it out.


If you need more design and customization options than the ones included with Portfolio Press, check out my new theme Portfolio+.

Suggested Plugins

You will need to Portfolio Post Type plugin to use the portfolio features.

You will need to the Options Framework plugin to enable the options panel.

Examples of Portfolio Press in Action

Some of these examples have been customized a bit and show the adaptability of the theme.

Michalis Palis
Kim Kermode
Todd Milbourn
Golden Retriever Adoption
My Labour of Love (customized)

Instructions and Common Questions

How to Set Up a Portfolio Item:

When you activate Portfolio Press, you will see a new post type called “Portfolio”. Click “Add New Item” and you will be taken to the edit page where you can add a title, description, and tags for your portfolio piece.

To add the portfolio image, click “Set featured image” on the right side of the screen beneath “Portfolio Tags”. This will take you to the media uploader to add your image. When you finish, click “Use as Featured Image”.

How can I make the portfolio display on the home page?

Create a new page, call it whatever you like, and choose the page template “Portfolio” (on the right side of the screen in page attributes”. This will now display the portfolio on this page.

Then under “Settings” > “Reading” click “Front page displays” a static page. Then select the page you just created that has the portfolio.

My Thumbnails Looks Distorted, Cropped or Weird

Try installing this plugin and regenerating them: http://wordpress.org/extend/plugins/regenerate-thumbnails/

How to Set Up the Menus

A lot of people were asking how the menus work. Here’s a video that explains it, plus instructions for how to create different portfolio sections.

404 Errors:

This theme uses custom post types. If you are getting a 404 error when you try and view the portfolio posts, reset your permalinks. You can do this by going to “Settings > Permalinks” and re-saving the permalink structure.

Portfolio Items Disappear:

If you deactivate the “Portfolio Post Type” plugin, your portfolio items will disappear. They are still saved in the database, but you need the plugin in order to access them.

How can I have different portfolio sections?

Use the portfolio tags or categories. These are like the regular tags in posts. You can also put the links in the menu- so, Portfolio could be your main menu item that display all the items, and then have a drop down menu with illustration, websites, etc that link to the tag urls and just displays those items.

How do I change the size of the thumbnail images?

At some point I will probably make theme options for this, but for now you’ll have to do this through the code. Open the file functions.php, and find the line of code that says: add_image_size( ‘portfolio-thumbnail’, 215, 175, true );. The first number “215” is the width- the second number “175” is the height.

If you change the thumbnail size, you was also need to install this plugin and regenerate thumbnails.

Is it possible to change a regular post to a portfolio post?

Yes, you can use the Post Type Switcher plugin to convert any type of post type to another. Or, Convert Post Types for bulk switching.

How do I change the number of portfolio items per page?

In functions.php of your child theme, add a filter:

function mytheme_posts_per_page() {
     return '16';  // Return however many items you choose
add_filter( 'portfoliopress_posts_per_page', 'mytheme_posts_per_page' );

(Portfolio+ has additional pagination options (12 or 15) and infinite scroll options.)

Can I stop the featured image from showing automatically in the portfolio post?

Yes, install the options panel and choose “Display images manually.”

Can I display my portfolio items in with my regular posts?

Yes, but you’ll just need to update the query call on every template where you want both to appear. See Justin Tadlock’s article about this. The intention of this theme was to have them live separately.

What if I have hundreds of images to upload? Is there any easier way?

Try using the Automatic Featured Images Posts plugin. In the settings, set the “Default Post Type” to “portfolio.”

Can I change the order that portfolio posts display?

The easiest way is to change the post date- that’s how they are naturally ordered. Another way is to use the Post Type Order plugin– though some folks have mentioned bugs with how the prev/next buttons work when that plugin is in use.

I want to lightbox my portfolio images. Can I do this?

Portfolio Press does not have support for lightbox images. You might try a plugin if you need lightbox functionality.

Translation Credits

Translations by Eduardo-Martí­n Larequi Garcí­a, Wolforg, Erling Håmsø, and Sandro Bauer.

Do you like the theme?

Rate it at: http://wordpress.org/extend/themes/portfolio-press

If you’d like to support this project, consider purchasing Portfolio+. It’s the same design as Portfolio Press, but with some bonus features like infinite scroll, additional customization options, and a portfolio category template. Enjoy!

About Devin

I'm a WordPress developer based in Austin, Texas. I run a little theme shop called DevPress and works for a startup called Cratejoy. Find me on twitter @devinsays.

1,943 Responses

    1. Thanks for the work on this, I’ve made the changes but I can only go back to past portfolio items, I don’t seem to be able to come back to newer posts.

      Maybe I missed something with the update, I just changed the three pages. I’ll try fiddling with it tomorrow, I guess other people will give their feedback as time goes on.

    2. Dear Devin,

      I use the most recent version of the theme. I tried changing post per page both in functions.php and content-portfolio.php. It changes on the main page, but it still breaks after 10 on tag page.

  1. I have an issue where there is a “Home” page that does not show in my dashboard page menu, does not display “featured image”: so I am not able to see any posts.
    So, after some time, I made another page using “Portfolio” template – and I can see all my posts there.
    But now I have a page that does nothing and shows everytime you first visit my site.

      1. Jamie

        Great theme Devin!
        I’ve disabled comments on my pages, I’d also like to remove the ‘comments are closed’ wording. Can i do that?

  2. David

    I think this plugin is almost ideal for a site I am developing. I was just wondering, is it possible to auto-generate lists of Portfolio Categories in a sidebar widget?

  3. Hi, I have a question. I have 9 thumbnails per page on my portfolio. And I have like 3 pages. But apparently, my ‘Older entries’ disappeared. I was wondering why I haven’t any visits on my older photos, and well, it’s because there are not there. How can I fix it?? I think it’s since the wp update. I hadn’t realized before. Thanks!

  4. HI,

    Great theme. However, is it possible to have more than 1 portfolio page? For example I have multiple photo galleries and I want each album page to contain multiple galleries portfolio style? Is this possible?

    At the moment when I create a new page and select ‘portfolio’ as the theme the page show as a replica of the homepage portfolio page…

    Many thanks,


  5. Hey, im using portfolio press to develop my blog, its rly nice, but im wondering if there is a way to use normal posts as portfolio itens, since i want to use the portfolio page as a featured posts page, and the only way ive found to do that is double post, one as portfolio an one as a normal post.

  6. Scott

    Hi Devin,

    I have constructed a website using this fantastic theme. However, I have a quick question regarding the number of items shown on a category page. The following page shows 10 items: http://www.saundersalbum.com/portfolio_category/uk/

    There is then navigation at the bottom which directs you to 2 other items. Why is there 10 items on the page when I though 9 was the maximum? Can I fit all these items onto 1 page?

    Many thanks again for a great theme,


      1. Scott

        Hi Devin,

        Many thanks for your response. It would also be nice if you can manually order the portfolio items… :)

        Thanks once again – my family love it!



  7. Tomas

    Hi Devin – Thanks for the great theme!

    I’m installed and the theme is working well. I have three questions for you (I’m new to WP and not super technical so I apologize if these are basic questions)…

    1 – I’m using the Portfolio page as my homepage. I’d like to add a “Welcome” message to the top of the page. Is it possible to add full-width text to the Portfolio page so that the text appears below the page title and above the portfolio images? I’ve used a sidebar widget in the interim but would prefer for the text to appear at the top instead.

    2 – Is it possible to have multiple portfolios appear on the same page? I’d like to create sections. A good example of what I’m talking about is http://www.callawaymedia.com.au .

    3 – How can I add an image to the header (in the black bar at the top)?

    Thanks so much!

      1. Sam Chapple

        It would be a good feature for the home page and categories. It’s not really great ‘SEO’ to have little or no text. Maybe a fix is a widget space below the header or something. Also same goes for the permalink titles to the portfolio pages. Also maddening is the lack of generation of media xml sitemap from the portfolio categories, anyone else having that issue? It’s the other plug-ins, not this theme.
        It’s a great template!

      2. loop.php and content-portfolio.php has the permalink comments (if one just wants the title and not preceded by ‘permanent link to’) when a mouse hovers over link portfolio images

  8. Jason

    Hi Devin. I converted my posts from portfolio to normal wp posts and everything is working pretty fine except for one thing. How can I make thumbnails appear in search results page or in category view? All I’m getting a titles but I’d like to have a thumbnail appearing before the title. See example of my problem here: http://www.jj-arts.com/category/wildlife

    Thanks for your help and hardwork!


  9. This is great thanks. Was wondering I want to change the order of the portfolio links, I have added more, but I would like the original portfolio items to be put to the top (not automatically pushed down the order), is this possible? thanks

  10. Diana

    I was wondering if you could help me build mine, I’ve been having a little trouble with making my pages have the same theme throughout. When I make a page and select the template portfolio it just links to the portfolio. I wanted to make the same theme but with different images. how did you make it like that on your website?

  11. Stamatis

    Thanks for this great portfolio theme! I am a total newbie so I would Like to ask you how can I remove the sidebar from the: 1) Items of the Portfolio, 2) From everywhere? But still have the option to bring it back with a few clicks/copy-pastes. Maybe having an option in the “Style and Layouts” tab in the feature?


  12. Hello,

    First, thanks for creating this fantastic theme!

    I’ve run into a problem and was wondering if you had any advice?
    When I updated to the most recent version, the option for displaying portfolio archives at full width stopped working. It doesn’t seem to make any difference whether the option is checked or unchecked, the sidebar still appears, and it doesn’t seem to use the full-width portfolio template.

    Can you suggest anything to try?


  13. Mike

    Hey, excellent theme! I have watched vid and read comments above and cant work out the following. How do you have 2 or more pages running different portfolio templates? I create two different pages and get the same portfolio images on both pages. Thanks in advance, love your work!

  14. Meghan

    Hey Devin,

    I’ve just started using your theme and I am trying to use it to display my videos but I can’t figure out how to link my video to the feature image so that when they click on the featured image it shows the video. Is this even possible? I uploaded the video just fine but I can’t figure out where I should drop it.

  15. Is there any way to change the order that your portfolio images display in? For example, I want all of my best work on the first page and the not so good work on the second and third pages. Out of the box, it seems like the only way to do that is to upload them in the proper order. Can I do this without reuploading them?

    1. Never mind, I just changed the dates of the posts and that will work just fine. There is something else I want to do though. I want to make my portfolio page a 4×4 grid instead of a 3×3 grid. How would I go about making that happen?

      Thanks for the awesome theme by the way, it’s helping me a lot.

  16. I have put the new version of the theme on the site and the previous posts link comes up now on the portfolio page but it only goes back one page and will not go forward, i i click on the last pic i can then go to the next picture on the thumbnail list that wont display in the thumbnail view, on my site there should be 3 pages of thumbnails on ‘all’ but only 2 show

      1. Sarah

        Having a similar problem here. I’ve got 2 pages worth of images, and while I can use the Older Posts on page one… Page two has only (another) Older Posts – which when clicked takes you back to page 2. There’s no Newer Posts to be seen. Re-downloaded the theme and re-installed it, same issue. It only seems to be the main portfolio page that’s doing this; if I view only images for one of my portfolio tags that goes to 2 pages, I get the normal Older/Newer functionality.

      2. Sarah

        Yup. Double-checked it – and went so far as to re-download the theme from your site and install it as a separate theme (alongside my existing one) just yesterday, as mentioned above. Same problem on the fresh version.

        I’ve got it set up with the static Portfolio page as my main page, as you describe above. Does the same thing if I’ve got the page type set to Portfolio or Full-Width Portfolio. Again – tag pages work as expected.

  17. Meghan

    Hey Devin I have another question for you. I figured out how to get video to play on the page, but only if there is not a featured image attached. But, If I don’t have a featured image connected the images on the Portfolio are black. Is there a way to fix/work around this? Or better yet is it possible to just use the first shot of the video as the featured image without having to screen grab it? I would prefer to not have the featured image show up when you click into the item. My website is http://www.meghanlopez.com if you want to see what I’m dealing with. Thanks again for the help!

  18. Hello..
    I install de 0.9 version today and appears a navigation menu “older posts” in the index page (my first page). I need it appears in category pages but not in the firs page of my blog.
    ¿Any way to change this?

  19. Judy

    I want to change the font colour on menu bar under the heading to black so I can use a white background. Where do I find the css in the style.css to make this happen?? With the white background option I can’t see the menu bar.

    Can anyone help????

    1. Use a tool like the Firebug add-on for Firefox to inspect the HTML and CSS on pages. It will help you quickly identify the lines of code that control each element on the page. You can also make temporary changes on-the-fly to test them before writing them into your files.

  20. Chris

    Dude, the back-end of this theme is fail.

    Needs special plugins just to use basic theme features and options. Uses a special post type without any real reason. Why not just use the tried and true featured category option plus featured image on regular posts?

      1. Chris

        From what I saw, the Portfolio Post Type was not optional if you wanted the portfolio page template to function at all. Yet it wasn’t included with the theme.

        I admin a multisite blog network with hundreds of blogs and I have tested over a hundred themes, so I know from plenty of experience that our users wouldn’t know what to do with this backend. I barely did.

        I do like the front-end of this theme, though, and I will try to keep tabs on future updates.

  21. Chris that was rude. If you don’t like the theme you can always ask for your money back. How much did you pay for it again?

    Thanks Devin for developing this great theme on your own dime!

      1. Chris

        Back to the multisite blog: our users don’t have access to installing plugins. I had to include the plugin code in the theme. I don’t like doing that in case the theme needs updates later.

        Thanks for being cool and not like “leave Devin alone!” guy.

      2. You mean this guy, “Dude, the back-end of this theme is fail.”? Yes, Devin apparently is way more cool than me. I wouldn’t have even answered a “question” that started that way. Anyway, carry on.

  22. I have currently installed Portfolio Press on my website and have it working fine. I love the theme and believe that it will serve my needs well, but I’m having difficulty overcoming what may be misperceived on my part as some initial limitations. I first have to say that I am a beginner with WordPress and new to setting up a website site. I have begun setting up a portfolio page with several items and, as several tutorials show, when I click on the item on the portfolio pages it goes to the item page. That works well. My difficulty however, lies in the fact that I need several portfolio pages imbedded into a single page so that when one item is selected in the parent portfolio the reader will be directed to another portfolio of different items related to that first item in the parent portfolio. I am an architect with several distinct projects and each project has multiple images associated with it. I would like to have one featured image on a parent page (say a rendering for example); click on that image; and be directed to another portfolio of images (IE: floor plans and elevations) rather than going to a larger featured image. Is there a way to do this easily?
    I have been able to set up several portfolio pages and even set up one as a parent to another, however, each page has the same set of portfolio items; and every time I create a portfolio item it shows up on every portfolio page. Every time I create a new portfolio page all of the same items show up. Is there a way of selectively targeting and limiting where the items are posted? Is there a way of clicking on a featured image on the parent page and being directed to another page rather than back to a larger version of the featured image? Any help in this matter would be deeply appreciated.
    Thank you for your time,


    1. Hello Robert,

      I believe you and I are in a similar position. But, I’ve come across a plugin called Portfolio Slideshow by Dalton Rooney that should work for you. The pluging works well with Devin’s Portfolio theme. I’m still currently updating my projects on my site. What I’ve got up should give you an idea though. Hope that helps!


      P.s: If my website somehow doesn’t appear along the submission of this comment under my name, it’s at http://www.linessplines.com/portfolio

      1. Hello Caryn,

        Thanks for the Heads up. I’ve have Portfolio Slideshow installed but have also tried File Gallery by Bruno “Aesque” Babic. It seems to work well with Devin’s theme, but with different results than Slideshow. Fell free to visit my site: http://www.workingdesign.info I’ve just begun to set it up but you can see the results.

        best wishes,


  23. Emily

    Hello, Devin!

    I love the theme. I poked around a while for a nice, clean gallery site and yours proved to be exactly what I was looking for.

    However, I noticed one thing– I started backdating some photographs of mine. The “Older Posts” link does not go further than /page2
    That is to say, if you’re on Page 2, it’ll just keep linking to itself. Page 3 and so on back are there, and I can link to them directly.

    Do you have a quick fix for this? Other than this small navigation error, everything else works perfectly!

    Thank you!

    1. Many thanks to Devin for a great theme out of the box, and an excellent theme to build from.

      As Devin mentioned, you need to customize the style.css files. I also use a few plugins for the lightbox effect on single post pages and a few of the other customized elements of the site.

      And, of course, I am available for hire to customize WordPress themes.

  24. MB


    Thanks for the great theme!
    As I understand, there is no option to make new posts automatically appear as portfolio items? Is there any workaround (plugin) and will it still be a feature for a future theme update?


  25. MB

    What I meant was, if I post a new post (blog post) incl a picture, can I make this automatically make this also a portfolio post? Or do I always have to create portfolio posts?

    The reason I am asking is because I want to make the portfolio the index (start) page of my blog which shows the latest news/posts. And I usually write the post via the WordPress iPhone app, which can’t access the portfolio tab.

    I hope this now makes more sense. :)


  26. Hi, as many people above, I have a problem with ‘Older entries’. It just goes till page 2, and then instead of going to page 3, it’s linked to page 2 again. And ‘Newer entries’ isn’t there either.
    And I have the 0.9 version (with the older version I had the problem that ‘Older entries didn’t appear, but when I asked, you said that it was going to be fixed with the new version).
    Is there any way to fix this??
    Amazing theme by the way.

  27. Andrea

    Awesome theme! It’s exactly what I’ve been looking for. Thank you for creating it and I think it’s great that you keep up with the questions that people have. My question was listed above, but I didn’t see a response (unless I scrolled past it). I’m wondering if it’s possible to have multiple portfolios. I am looking to have a portfolio for each category on my site that would only show the images of the items in that category. Not sure if I’m being clear enough in my explanation. Thanks in advance.


  28. Hey Devin,

    Love the theme. Working on setting mine up right now!

    Question: Is there anyway to edit the thumbnail manually in the theme? I’d like to be able to crop a few of my logos differently than the default cropping. I’ve tried Regenerate Thumbnails,but that doesn’t seem to work.

    Any advice would be appreciated!

  29. Julien

    Hi Devin! First of all, thank you for this theme, it’s really neat and easy to customize, even for a first-timer like me!

    I have a question, though.

    I have created two portfolios on my site, one for my print projects, one for my motion design projects, thanks to the “portfolio tag” trick. Now, here is the tricky part: my regular pages (“home”, “about”, “contact”, for example…) each have a title on top. I would like my two portfolios to display the title “motion” or “print” in the same fashion, to keep a visual consistency in my site.

    How to add a title to each of my portfolios, knowing that “portfolio tags” aren’t regular pages? Do I have to add code lines in the style.css in the portfolio section? This is buggin’ me so much.

    A good example of what I would like to achieve is the Golden Retriever Adoption site with its title and text on top of the portfolio.

    Thanks by advance.

  30. Hi Devin, I really love this theme, but am having problems. I set my portfolio theme up with 18 items so I could have 2 pages. Last night (2/5/12) it was working fine. Today, it isn’t. I went to your github site and replaced the php code that you updated 3 days ago, and it’s still not working. I get the “Well, this is embarrasing” page when I try to navigate to page 2. My site is http://www.cindyology.com Any help you can provide will be greatly appreciated.

  31. Hi Devin,

    I am enjoying you theme. Everyon who has visitied my site tells me it looks good and is easy to navigate. Your blog has also been very helpful. My question involves the text below the comment box which reads: You may use these HTML tags, etc. etc. Is there a way to remove the text either visually or by going into the text editor?



      1. Thanks Devin,

        It worked fine, however, it also changed the appearance of the Post Comment button. It lost it’s gray background and raised button like appearance. Being new to all this I am uncertain how to fix it. Could you further advise.



  32. Nic

    Hi Devin ,

    This is a great theme that you’ve developed and I’ve not found any problems.

    Just one question : Which share/social plugin works best with your theme.

    I’ve tried the popular “Sociable” plugin , but it doesn’t seem to show up on the post. ( Or any coding that I must insert to make a share/social plugin work)

    Thanks for the great work!


  33. Vishal Kambli

    First the credits:
    Thanks Devin for such a wonderful and excellent theme, its exactly what I have been searching for a week now. Its simple, clean and easy to work around for a newbie like me. Keep up the good work.
    Now the problem:
    I am using a page with a Full-Width-Portfolio template for the homepage, and my problem is that the on clicking any thumbnail, the user is taken to http://www.mywebsite.com/portfolio/mypage/ instead of http://www.mywebsite.com/mypage/
    I want the user to be taken directly to the post.
    Any suggestion or solution will be greatly appreciated.

      1. Vishal Kambli

        Thanks Devin for the quick reply. As I am a newbie to this, so I will have to try this out on my offline site (setup using XAMPP) before using it on the online setup. Currently I am using a hard coded HTML page for the Home.

Leave a Reply