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. Hi Devin,

    I have searched the internet, but could not find it.
    Is there a way to have a widget showing the latest 5 portfolio items?

    Thanks in advance.

      1. Oh cool, thanks. So are there short codes specific to this theme or what are the tags that need to be use in the different formats to be formatted in their certain way. for instance what is used for the gallery shortcode for the gallery format on this theme? Thanks again!

  2. I’m not understanding the purpose of the format widget and the four options standard, gallery, quote, and image when editing a regular post. Would you be able to explain a little bit more on the functionality of this option? Thank you I’m really digging the theme.

  3. mauro

    Wow. I’ve changed the number of thumbnails in content-portfolio.php file. 9 to 30 to simulate an infinite scrolling (till I’ve least of 30 issues ;)

  4. emily

    i’m wondering how to disable the post sidebar on the individual portfolio posts. i’d like them to have the full-width page template. i am making a child theme, but having trouble figuring this one out. thanks !!

    1. emily

      i disabled the sidebar by deleting a bit of php in the single-portfolio.php (in my child theme) – worked perfectly.

  5. Hi Devon,
    I love this site template.

    Can you tell me how to put my resume on as a menu link without it showing up in the homepage feed? I only want it to show up when the link is clicked.

    Thank you!

  6. Martin

    could you please help me a bit?
    I am trying to get the navigation right in the center of the page. Still cant beat this problem

    1. Hey Martin,

      You’ll need to change the position through a combination of the Header file and the style.css file.
      The portfolio press is programmed to have the “navigation” (this is the word to look out for in the files) to the right of the “logo”. To do this yourself you will have to unlink them so they are independent.

      I hope this helps, there’s lots you can do with your navigation bar – take a look at my page for example :)


  7. I wish to reorder the featured images on my static front page. I’ve created a video portfolio, and wish the most recent videos to appear in the top squares. How is this accomplished? Many thanks.

  8. emily

    I am using the [custom_gallery] shortcode, and am getting a two column layout for my thumbs. I am wanting a four column or even five for my thumbs. Any help on how to do this would be appreciated. Thanks :)

    1. emily

      i just gave the portfolio posts class a greater width and got four columns, so solved the prob well enough. also adjusted the widths in the media queries for mobile.

  9. In an effort to gain more control over my images and their display, I’ve installed the nextgengallery and am not trying to make this page my Home page, but it doesn’t perform the full functionality (i.e., slideshow) when I do this. I also plan to the Lightbox feature plug-in.
    We love your site, but wanted more diversity it how to display the full, noncropped images, and a slideshow, lightbox, etc.

    Any suggestions?


  10. It’s entirely possible that I’m just doing something wrong but I thought I should check in case it’s not me and it’s the theme – do pingbacks work from portfolio posts? I use the theme for my blog but pingbacks to sites I link to never work.

      1. Hi Devin,

        thanks for the quick reply (as always!), even though it’s not the reply I was looking for. I would rather I was an idiot and doing something wrong…

        But now I know what’s happening, thanks again.

  11. Seraf

    I’m trying to get the portfolio to show 30 thumbnails in rows of 6, 100x100px. I changed the number of thumbs per page like you explained, which worked fine. I then downloaded the Regenerate thumbnail plugin, but now all I have are big blurry thumbs, still in rows of three. I am completely new to php, so maybe I missed something.

  12. I see you’ve updated the theme from 1.1 to 1.2. Could you tell me what is updated, and whether tweaks to the design will disappear if I update?


  13. Alexandra

    I’m trying to change the size of the header (bar) at the top. It is currently too big and takes up half the page above the fold. Please advise on how I can make it smaller? I’m new to WordPress, but I have a feeling this is simple to do. Thanks!

  14. with the update to 1.2, the shadow with gallery name appearing when you pass over a portfolio item disappeared.
    Is there a possibility to have it again?

      1. Eric


        I love that shadow with gallery name feature that happens when you hover over an item, and need it back too!

        Thanks for the great work on this theme.


  15. Hi — thanks for a great theme! I’d like to reduce the width of the space between the main column and the sidebar to allow bigger photos in the primary blog content. I’m a CSS novice so I’d appreciate help on what I need to change in the stylesheet.

  16. Meghan

    Hi Devin,

    I’m a bit of a n00b when it comes to WordPress, so forgive me if my question seems a bit simple…

    When inserting an image in a post it with give me text wrap options, but none of them seem to work, and my text will always appear below the image. Is the theme doing this on purpose? How can I fix it?


  17. I should probably know this, but I am trying to remove the “Posted on…” and “this entry was tagged…” from my single posts. Where can I remove those?

  18. The thumbnails in my blog posts are no longer wrapping properly with Portfolio Press 1.2 (i.e., text starts at bottom of thumbnail). The problem goes away if I switch to a different theme. Is this something that will be fixed in the next version?

  19. First of all, thanks for this great theme. It’s exactly what I was looking for. However, I am really struggling to implement a layout change that is rather important. Let me explain.

    In my website I have configured the theme to load the “portfolios”. In my menu bar I include a link to each of these portfolios and an additional link to the blog. In spite of selecting the theme layout as single column, I would like only the blog section to display a sidebar and have the two column layout.

    What I did was create a child theme and include an additional template file, based on page.php, but with the following modification.

  20. Hi Devin. Thanks for the really excellent theme, which I’m just starting to get to grips with as I’m a complete novice to WordPress.

    One quick question based on some examples that you’ve indicated in your description of the Theme. Is there a simple way of changing the colour of the header menu items (Home, News, About etc.) I’d really like to have a plain white background for my header because my logo looks best on white, and I’d like to switch the colour of the text there to match the green in my logo.

    Thanks for any advice you can give.

      1. Tony Seddon

        Hi Devin. Thanks very much for the info, and for the video which fully answered my question. The type is now the same colour as my logo.

        Portfolio Press really is a great theme, just right for my needs, so thanks again for making it (and making life a lot easier for me). I shall definitely take a look at Portfolio+ as you suggest.

  21. Elisa

    Hi Devin,

    I am very new to Word Press specifically and blogging in general. Thank you for providing a lovely theme. How can I set titles and descriptions for my portfolios? I see that one of your exemplars – the Golden Retriever Adoption site was able to do it on their home (portfolio) page. Please advise. Thanks in advance!

  22. I love this theme, as it is working very well for what I need.

    I’m having a problem with the featured image on my portfolio pages being shown much larger than they should be, and distorted. As this is a problem that I know is not a result of me modifying anything, I’m hoping you can help. Was there an update recently, or what do you think might have caused this?

    Thanks for any help you can give.

  23. Devin! I love this theme for my art page: but I have a more complicated site needing a theme: quick question, i hope its not redundant: can i do video posts in Portfolio? and audio players? is portfolio a child theme on the genesis framework? i am looking for a simple straightforward, great SEO, clean, fast to navigate, multimedia theme for my consulting business as a vocal coach. i need international translation capabilities, and links to clients that dont lose the conversion. any advice would help Ive been in DIY too long and backstepping over some errors i made getting too invested in a theme i have no support for ( Boldy)

  24. Cindy

    Is there a way to disable comments on individual portfolios? I unchecked the “Discussion” and the “Comments” boxes under Screen Options, but the comment are and all associated content are still present.

  25. Hi Devin. Is there a reason why a plug-in like Easy Fancy Box doesn’t work on images inserted directly into a Portfolio post? If I make a regular post with an image it works OK, so I’m wondering of this is something to do with the Theme. It’s not that big a deal at the end of the day but I tend to keep images in posts fairly small and it would be good if viewers could see full size images easily. Thanks, Tony.

    PS. Really like Portfolio +, well worth the paid upgrade from Portfolio Press.

  26. Eve

    Hi Devin,

    I’m new to wordpress.
    I am having problems dragging a menu item slightly to the right of the menu item above it to create a hierarchy (parent/child) relationship in the menu, this was working before I installed Portfolio Press. How can I get this function back? Thanks, Eve

  27. Rachel

    Hi Devin. I heard about this theme at WCSF today and think it’s absolutely fantastic! One feature I’d love to use is a Portfolio Categories widget – something that will display links to the portfolio categories that have been created in the sidebar. Is this possible (perhaps with another plugin)? I realize I could make a custom menu and copy and paste the urls to do this, but I’m hoping for a more automated process. Any input you have would be greatly appreciated.


  28. Devin, I would like to direct a user to a totally different website URL when they click on a portfolio home page image. I have managed to do it using an automatic redirect when the the portfolio image page is called up. Is there a cleaner way to do this? Thanks – Rick

  29. Hello

    I love your theme – thanks. I’m trying to reorder my portfolio items – I have 9 displayed but can’t work out how to do it. I know when I loaded them there was an option on how they display – by post date, random etc but now I can’t find it! Please advise :)


  30. Kraner

    I am using portfolio press on two different sites. One the thumbnails are nice and big and the other they are little as can be. Any thoughts? is this problem fixed in Protfolio+ I am thinking of geting it anyway. thanks

    kranerdesign.com <- large skwintprints.com <- small

    1. fred

      Not to answer for Devin, but you might want to look at: /portfolio-press/js/theme.js

      $(this).children(".thumb").stop(true).fadeTo(300, .5); // Sets 20% on hover

      set fadeTo ([setTime], [setOpacity])

      Hope that helps.

  31. Fred

    Hi Devin,

    Great code! Perhaps you could give me a quick clue to adjust theme.js so .title-overlay opacity is always set to 1.0. I don’t wish it to fade in or out – just always be there.

    Thanks Devin!

    1. Fred

      Never mind, Devin. I figured it out:

      1) commented .title-overlay functions in theme.js

      2) added to child css:

      #portfolio a.title-overlay { display:inline !important; }

      Thanks again!

  32. Hi Devin,

    can you tell me how to change the text on the footer?
    I’ve forgotten how I did that and now my copyright is outdated.

    Love this theme!

    Thank you,


  33. Fred

    Hi Devin,

    Any quick thoughts as to the best way to approach adding additional text to portfolio thumb text overlay?

    My thought is to draw from Media: Caption or Description or maybe a custom field and then adjust theme.js accordingly.

    Does that make any sense? Thanks!

      1. Fred

        Of course! Easy with custom field meta. I did have to add custom-fields support to portfolioposttype(). After that it was a simple matter of creating a custom field named ‘subtext’ and calling it with echo get_post_meta($post->ID, "subtext", true); in content-portfolio.php.

        Perfect! Thanks Devin.

  34. Leigh

    Hi Devin! Great theme that I’ve been using for a long time on a friend’s site. However, I just had to update her from 2.x WP and one of your much earlier versions of this plugin. For some reason it completely deleted the categories–weird! Anyway, got that fixed but am having two other issues. First, the overlay text on the portfolio items is staying up when it loads and disappears on mouse over. The other issue is the site is not scrolling in IE, Chrome, or Safari. She says it doesn’t scroll in IE, either, but I don’t have a way to test that. Firefox and Opera scroll just fine. Any suggestions? Any help would be much appreciated.


  35. Leigh

    I also should note that I changed the home page to show 16 ($query->set( ‘posts_per_page’, ’16’ );) but it still only shows 9. :(

  36. Tim Anderson

    slowly catching on, really good job you’ve done,i am really excited about how easy this is gonna make things
    for keeping my portfolio! is there any way to control how the thumbnails get cropped
    would like to have more control of what is shown, tried re-cropping in psd, to my likes (picky artist)and replacing the thumb with an identical named file but got now where, any help appreciated

  37. Tom

    Hi, Nice theme!
    I think there may be a conflict in using Firefox 14.0.1, and the jquery for the hovers function – js/theme.js?ver=3.4.1
    the hover is not appearing and the page loads endlessly.
    any tips?

  38. Hi Devin

    I have Portfolio+, which has options only for 9 and 12 images per page. I have seen your instructions for changing the number of items per page (Change: $query->set( ‘posts_per_page’, ’9′ ) in functions.php, and: ‘posts_per_page’ => 9, in content-portfolio.php.) and followed them but I am still getting 9. Do I need to do something else in P+ to make this happen?

    Thanks for your time –


  39. Some jerk hacked my website and I had to start over from scratch. He probably did me a favor as I like the Portfolio Press theme much more than what I was using before, but still. Grr.

    Between poking around, watching your videos and reading other comments, I have figured out how to do most of the tweaks I would like to do, such as changing the color of the heading and deleting the side bar on individual portfolio pages. However changing the size of portfolio images on the home page eludes me.

    I am featuring children’s books that I have written, which are in portrait rather than landscape format. I like the way they show up in the individual portfolio pages. However, on the home page, if I choose the full-page portfolio template, the images are much larger and therefore fuzzy. But using the portfolio template, there is a narrow strip cropped from the top and bottom of each image.

    I have been perusing the php and css files, but haven’t discovered a way to resize the images.

    Thanks for any guidance your can offer.

Leave a Reply