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,941 Responses

  1. Howdy, Devin:

    Is there a way to move photos from one gallery to another in order to preserve comments or do I need to re-upload images into a new gallery? I’m not having any luck using the “Add To Post” button under the Media Library. Whatdo?
    Thanks, man!
    Great theme!

  2. First, good job on the template! I enjoys it. How do I create a portfolio style gallery in additional pages? I really like the portfolio template, but am having trouble doing this for my other pages.

  3. Homerina

    Could you tell me in which templates and what I need to change to get rid of pagination on my portfolio page? For some reason even though I am attempting to edit it I must be doing something wrong because it breaks after 10 (I changed the breaks to after 4, at least I could do that right!). I am just seeking to have a complete, unpaginated portfolio page for all my items, which aren’t very many.

    Thank you!

    1. Homerina

      I apologize, I didn’t realize their were earlier pages to these comments, and I found the answer to my question. I am also updating to version 1. Thank you!

      1. Quite new to WordPress, this was driving me bananas until penny dropped and I checked the reading settings for the site. The default number of blog pages is 9 – set it higher and you will show more of your portfolios on a single page.
        Hope this helps someone – I suspect Devin probably thinks this is schoolboy obvious….
        live and learn.

      2. I have edited the post per page in functions.php but it doesnt change anything.

        i also have no “default number of blog pages is 9” in settings/reading.

        Have i missed something?

      3. @Brian – it’s in functions.php but I changed it to 30 but nothing happened, I don’t know if it is also on another page, I’ve looked but I can’t find it. I used to be able to do this no bother but one of the last updates lost the function for me.

        Any help would be appreciated as I’d like to go back to having 30 posts per portfolio page – I don’t use the blog and have the portfolio options set as my home page.

        I believe I’m up to date with Options Framework, Portfolio and WordPress.

      4. Good grief, spotted it in the notes just after posting;

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

        Change: $query->set( ‘posts_per_page’, ’9′ ) in functions.php, and: ‘posts_per_page’ => 9, in content-portfolio.php.

        Apologies for missing the blantant instruction in the FAQ!

  4. Hi Devin, congratulations for the theme. It’s really simple and beautiful! I’ve just installed it but the “PORTFOLIO” tab doesn’t appear on the left. I’m using WordPress 3.3.1. Could you help me?


  5. Elena

    Dear Devin,
    I have portfolio page with 3 x 3 items (as default). I also have pages per each portfolio tag – but somehow it has 3 x 3 +1 extra item (on the left, bottom) – why is it so?
    I only changed the size of items (to 200 x 150).

  6. daisy

    Dear devin,
    I can’t find the file portfolio-post-type.php in the “extensions” folder.There is the options-functions.php in it only.

  7. Daniel

    Hi Devin!

    Love your theme, but I decided to use it without the actuall portfolio feature. I just think that the theme is simple and great to build upon. I have one problem though. I still want a page called “Portfolio” with a permalink with the same name, but somehow your theme seems to use that permalink to display the built in portfolio, or something like that. Is there any way to disable this?

  8. Great theme!

    Running into a problem: the portfolio categories no longer appear on the appearance > menu page. I’d like the portfolio categories to appear in a widget on the sidebar. I was using a menu to do this.

    Is there a fix for this? or, Is there another way?

  9. Dear Devin,

    I keep getting this error and I don’t know how to solve it I hope you can help me. Many thanks in advance…

    Fatal error: Call to undefined function the_post_thumbnail() in /home/chefson1/public_html/raquel/wp-content/themes/portfolio-press/content-portfolio.php on line 47

  10. Love the theme and am currently using it for my site. I cannot locate documentation on setting up an image gallery in blog posts. Nor can I find documentation on setting up single image posts with that nifty onmouseover caption. The video does not explain this. Where do I go?

  11. Zeuberto

    Hi Devin, first, congrats for your portfolio theme, it’s really cool. I have a question: I would like to display the (portfolio) category name next to the item title, on the portfolio index page, I’m trying to use the usual “the_category();” next to the title in “content-portfolio.php” (line 48), but nothing happened, it can’t find the category name, and I don’t really understand why, with the global $post defined before, it should be found? Or maybe I’m miundertunding something? Hope you can help because it would be cool to display the category name next to the title (with possibly, a link to this category?). By advance, thank a lot if you could help me !

  12. Ale

    Hi Devin! Where can I find the function that gives to the body of one portfolio category page the class term-“slug”?
    thanks in advance

  13. Hi Devin,
    First of all, congrats with this nice theme! You can see it on my site. I have put some categories in the menu but when I choose one of these, there are suddenly 10 items on the page instead of 9. How come? I see that this issue is mentioned several times but I find no answer. Maybe you can help me with this. Thank you in advance!

      1. Hi Devin,
        Found a solution which works for me: in the general settings of WordPress where you can set the number of posts on a page I change the 10 to 9. It’s a different story if you want to have different numbers for portfolio and blog posts, but for me this is OK.

  14. An Awesome Theme! Your video was helpful. I’ve been trying for the longest while to get my website together, but found each theme that I chose difficult. Thank you so much for this easy to use theme! I would like to know if I would be able to disable people from right clicking and saving my photos? Thanks again! :)

  15. Hey!
    I wanted to know about the SEO in this. I’ve installed the All in One SEO Plugin but I can’t seem to do the SEO for the portfolio options.
    Could you tell me more about how this theme would incorporate the SEO aspects?

    Thanks :)

  16. Hi again!
    I also wanted to ask if there is a way to show portfolio thumbnails on the homepage of images added from URLs. As currently, I can only add images in the portfolio if I upload them.
    Is there a way to it?

    Thanks. :)

  17. Jessica

    Hello, how do I change the size of the boxes on the portfolio page? Figured out the thumbnails but not the boxes… thanks!

  18. Annio

    I’ve created a full width portfolio home page but when I add a portfolio item I just get a black rectangle on the home page and not the image I’ve uploaded. What am I doing wrong?

  19. Hi Devin,
    Love this theme! I have updated the theme from v0.8.3 to v1.0 and the Options Framework plugin from v0.9 to v1.0.
    If you look at the gallery pages they are not working. Pens should show only pens, clocks only clocks, etc. It seems we have lost the link structure? Tried to fix in permalinks but it won’t allow any changes. If I click custom and save changes, it automatically jumps back up to Month and name. But the problem remains and the galleries don’t work. They were perfect prior to the upgrade.
    How to solve this? The host does not offer tech support on creation or maintenance of WP sites.
    Thanks for any help.

  20. Hi Devin,
    Thanks for this great site… I’m just getting started with it and I can’t figure out how to set ny home page to a static page. I watched your tutorial (very helpful) but when I go to Reading settings I do not have the option of a static page etc. I do have 2 pages created but it still does not show the options you discuss in the video. Any ideas?

  21. Yes backup available for the child theme but is with the older version of portfolio press. Tried deleting the .htaccess file, WP made a new one but the problem did not resolve with the galleries. Any other suggestions?

  22. I am moving my website from CM4all to wordpress and this looks interesting. I am wanting to display my artwork and it is many different sizes.
    Will I be able to have different sized pictures in my portfolio? Or will it look funny?

  23. Spencer

    Hey Devin,
    Quick question, I wanted to have multiple pages of portfolios, for example one page called nature with portfolio items of nature photos, a different page called people with different portfolio items of nature photos.
    However when i create multiple pages i cannot put different portfolio items on each page. All the portfolio items show up on all the pages. Is there anyway for me separate different portfolio items onto different pages?

      1. Spencer

        i added photos to separate categories, but is there anyway i can make them show up only on that categories page and not my home page as well?

        Currently all my portfolio items show up on my home page but i would like them to be divided into the separate categories on separate pages.

        thanks in advanced for your help.

  24. Mike

    Hey, I have not done any work on my site for a while. I have upgraded everything in wp. I have options framework 1.0 plugin running. But for some reason there are no theme options under appearance any more. I am just learning and you web site is great to pick it up!

  25. Hi
    Brilliant theme, thanks so much. Was just wondering if there’s a way to change the order of the items displayed in the main portfolio without deleting and reposting them?



  26. Hello Devin
    i have same problem as Ika that she mentioned before:

    “As you can see “Older posts” link directs to “http://www.jedzonkomalucha.pl/page/2/” which is incorrect, as such page does not exist (as I do not use regular posts at all on my page), it should be “http://www.jedzonkomalucha.pl/portfolio/page/2/”. The interesting thing is that when you navigate manually to “http://www.jedzonkomalucha.pl/portfolio/page/2/” , “Older posts” correctly directs to “http://www.jedzonkomalucha.pl/portfolio/page/3/”. ‘

    Could You help me with this problem ?

  27. Adrian

    Must say this is a great theme I love the way the images show up and when you hover over them title appears. Id like to find out if when an image is click is it possible to use one of the lightbox plugins to show the photo and then the option to do a slideshow through the rest. As I don’t want it to link post page but rather popup with the image.

  28. Adrian

    Thanks tried that one I think been through a few, I have seen that page though Ill try it gain. Best I got was it stuck to the bottom however if you resized the window of Firefox it then appeared over the rest of the site, a front layer(PS CS5 term not sure of the web version). Id still like to a find our if it’s possible to open the image up in a Lightbox style popup when it’s clicked rather than they way it currently works.

    I must say I’ve looked at loads of site by dev’s and you are most responsive I’ve seen thanks very much for all your help and kudos to you for all you help.

  29. J-F

    Hi Devin!

    This is a very nice theme indeed. I’m currently getting familiarized with it but there’s only one thing I can’t get my hands on.

    When you mouse-over the “featured images”, the image darkened and the title of the image appears. How could I make the title to display at all time, without having to mouse-over it?

    Could you help? Thanks! Great work!

  30. Elly

    Hey Devin,
    Thank you for this wonderful theme.
    I would like to have my thumbnail of the featured image link straight to url and not to the post.
    How can I do it?
    Thank you

      1. Elly

        Thank you for the fast answer Devin,
        Since I dont know a lot about coding, can you please give me the line that I need to edit to be able to point the image to the image url link.
        Thank you and Happy Easter,

  31. I had portfolio press working fine, then changed themes a few times and went back to portfolio press. Now my portfolios dont display on my home page or anywhere. They are all there, i can edit them but they dont display anywhere, and i cant convert them to pages or posts.

    How can i restore them?

  32. Hi devin! I like your theme and I am using it for a photography site. I am using the theme with jigoshop. When jigoshop installs it auto creates pages for you, one being a shop page. For someone reason this page is not allowing me to make it a full-width page and I don’t get it. Its just a normal page like the others I created. Can you take a look ? http://ngwdcny.com/blog/

    Thanks Craig

  33. I *love* this theme! As someone just getting used to using themes, I’m finding this is very easy to manage.

    I’m still getting used to the style sheet, though, and wanting to change both the background colour and the header colour. Frankly, I’m just not sure where to look. Help!

    1. Hi Januska,
      I had trouble figuring this out, too. I changed my header color and background color using the following instructions. You can see the result at my web site http://cottonridgellc.com.

      Change Header Color
      Go to Appearance: Theme Options: Style & Layout Tab
      Click on the box under “Header Color” and choose your color.

      Change Background Color
      Go to Appearance: Editor

      Click on Stylesheet (style.css) at bottom right if not already there.

      Find in code: #main

      background: #fff (fff is the 3-digit code for white; use the code for the color you want – see http://www.december.com/html/spec/color3hex1.html for color codes)

      Also, be sure to remove the “url(images/bg-texture.png)”.

      Hope this helps!

  34. Hi Devin,
    How can I put text above the portfolio gallery?
    I’d like the portfolio as my homepage, but I’d also like to write a couple of paragraphs before the images.

    Many thanks,


  35. Hi Devin. I’m using your theme for a graphic design portfolio. I love it but I have a problem.
    I created an home page with all my work and a menu with 3 categories of my works. I have set to view 24 post for page and in Home page is all right. But in each categories i can view only 10 post for page. Why? I don’t get it. Thanks

      1. Thank u for the answer but the code was ok and in home page post per page are 24, as i want. The problem is in categories.

  36. brian

    I would like to be able to change the font and color of the title and other headings.

    I have managed to change some but not the blogg title. I know i can change it to a logo but i prefer to change the font and color thru code in a child theme.

    How can i find and identify each heading?

    1. Brian,

      Go to this section of code in your Style.css
      #logo #site-title, #logo #site-description {
      font-family: Georgia, serif;

      Change the font family.

      If you’d like more fonts, install WP Google Fonts. Once you have done that, change the font of H1 (Header 1).

  37. I have successfully changed the number of portfolio featured photos while i am in admin mode. But when i log out and view there are only 9 showing and the remaining ones do not show and there is no second page either. What have i done wrong?

    1. Brian,

      As a first step please delete your browsing data. What you see on your site may in fact be an old version. Google “how to clear cache for “. Where is Chrome, Internet Explorer, Firefox, Safari etc.

      Hope this helps,
      If not, write back.


  38. brian

    How can i change font color the menu items listed under blog title ( actually the page titles). I have searched and changed all the entries in style.css and nothing has effected them. Have also searched on line but nothing for portfolio press. Thanks in advance.

    1. brian

      I have finally been able to change menu colors and fonts in the style.css file.

      Am sure i did the same thing before but it didnt work then, wondering if a plugin was interferring. Since have disabled any plugins that i was not using. Here’s the code:

      #navigation {
      font:14px/14px Zapfino, Arial, sans-serif; /*menu items font*/
      padding:20px 0 10px;

      #navigation ul a {
      color:#333; /*menu items color */

Leave a Reply