I’m proud to announce a new html5 portfolio theme. It uses custom post types for portfolio pages, WordPress menus, supports image and gallery post formats, and has a ton of other neat features.
Here’s a video screencast of how it works:

The theme is in the WordPress Themes Directory. You can demo it here. Or download a copy and try it out.
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 the Portfolio Theme in Action
Golden Retriever Adoption
Black Frame Media
Panama Hats for Sale
Saturday Afternoon Filmmakers
Credits
Portfolio was built on the solid foundation of Toolbox:
http://wordpress.org/extend/themes/toolbox
Styles, especially the menus and buttons, were inspired by Canvas:
http://www.woothemes.com/2010/02/canvas/
Jquery rollovers for portfolio items was based on code by:
http://graphpaperpress.com/themes/workspace/
Translations by Eduardo-Martín Larequi García, Wolforg, Erling Håmsø, and Sandro Bauer.
Special Thanks
Also, special thanks to Michael Fields and Jake M Gold who helped test the theme and gave excellent feedback + code suggestions.
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 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.
Whitescreen of Death:
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 portfolio-post-type.php in the “extensions” folder, and fine 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. Note, that there is a clear div generated every 3 items to start the next row- so if you change this to only have two items across, you’ll also need to update that code in archive-portfolio.php.
If you change the thumbnail size, you was also need to install this plugin and regenerate thumbnails.
Can I stop the featured image showing in double in the portfolio?
Yes, install the options panel and choose “Display images manually.”
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.
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.
My Thumbnails Looks Distorted, Cropped or Weird
Try installing this plugin and regenerating them: http://wordpress.org/extend/plugins/regenerate-thumbnails/
Do you like the theme?
Rate it at: http://wordpress.org/extend/themes/portfolio-press
Some folks have mentioned paging issues on the portfolio pages. I think I finally nailed this bug fix in the latest commit. You can download the most recent version of the theme from GitHub: https://github.com/devinsays/portfolio-press
If you want to change the number of items that display in the portfolio, you’ll edit the line in functions.php:
$query->set( ‘posts_per_page’, ’9′ );
If you want to change the number of items that show on the portfolio template (generally when you display it on the home page), you’ll also need to update the line in content-portfolio.php:
‘posts_per_page’ => 9
If you’ve previously set posts per page in the reading options, this change will override it.
If there is enough demand, I can make it an option in the options panel.
There’s a few other tweaks I want to make, and then I’ll release version 0.9.
Cheers!
(Also, if you like this theme, don’t forget to rate it: http://wordpress.org/extend/themes/portfolio-press
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.
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.
How can I disable comments on all pages?
Look under “Settings” > “Discussion” in WordPress. You can also disable it on individual posts and pages using the option on that page (under the editor).
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?
You could just remove the comment call entirely from the theme if you are not using it.
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?
Hmm, I should have searched WordPress plugins first!
Turns out that Query Multiple Taxonomies (http://wordpress.org/extend/plugins/query-multiple-taxonomies/ ) does exactly what I want. Maybe someone else will find it useful too.
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!
The latest version on GitHub has a fix for that: https://github.com/devinsays/portfolio-press
I have a couple other updates to make, and then I’ll get it into a the WordPress.org repository.
Oh great, I’ll wait till it’s on WP then. Thanks!!
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,
Scott
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.
Post formats are going to be supported in the next version, but it’s not here yet. Another theme might work better for you if you need that functionality right away.
Thanks, ill use a simple featured slider until next version arrive.
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,
Scott
It’s a bug. You can set it under “Settings” > “Reading Options” to 9 manually. The next version of the theme will have a fix.
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!
Regards,
Scott
Scott, you can “fool” the portfolio into any order you want by changing the date of the post and saving.
Thanks John – A great tip!
Scott
Is it possible to display the list of categories on a page? The same way that single category page display it’s items?
There’s a taxonomy widget if you wish to display Portfolio Categories: http://wordpress.org/extend/plugins/taxonomy-widget/
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) You’d need to edit the template. index.php (or archive-portfolio.php if you have that set as the the home). You’d use conditional logic to say if is_home() { display your message }, in the spot you want it. See: http://codex.wordpress.org/Conditional_Tags
2) Not an easy way to display sections. You could create a page with the images, and then link those to the tag archives.
3) Edit style.css.
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!
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
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!
Jason
thank you, this is really what i want, and it’s free…
Is it possible to change the number of columns on my portfolio page? …and I also really like this theme. Thanks.
You’d need to edit the image sizes (in functions.php and styles.css), and change where the clear div goes in archive-portfolio.php. Not particularly easy if you don’t have development experience, but is possible.
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
Nothing built into Portfolio Press to do that currently. A sticky post might be a good idea though- I’ll look into it. For now, you’re best off just changing the post date.
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?
Did you watch the video showing you how to set up items?
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?
thanks!
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?
Thanks,
Ocean
It appears to be working for me. Try resetting your options or downloading the theme again.
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!
You can view portfolio tags or categories, which will only have the items you put in those sections.
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.
You could put the video in the portfolio post content. Then when they click the feature, they’d see your video. Use the Options Panel to turn of the display of images by default in portfolio items if you want to do that.
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?
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.
Check some of the older comments. I feel like I posted this recently. Would involve editing the templates.
You can change the date of the post.
Quick question…. I can’t seem to find the css to change the colors of the menu. Any help would be appreciated
Use firebug to see what styles are being applied an element: http://wpmu.org/customizing-your-wordpress-theme-using-firebug/
Hi Devin, how stable is 0.9 and when do you plan on releasing it to WP repository?
Thanks,
Vinny
It’s been submitted and approved in the WordPress repo, it just hasn’t been synced yet. Expect it out soon.
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
Not sure what is going on. Try installing the latest version 0.9: https://github.com/devinsays/portfolio-press
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.
It’s working for me in my tests. Are you using the latest version (0.9)?
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.
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!
Install the options panel and set it so the featured image doesn’t display by default.
i already had mate, i also re-installed it twice and tried the previous version too
Okay, maybe I’m not fully understanding the question then. Can you send me a link to the site where you’re having the issue? Might be easier via e-mail devin at wptheming.com.
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?
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????
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.
Hey Devin,
Is there a trick to posting .swf files? When I upload one to a post, it just displays a link to the flash file, but not an image.
You generally need to use a plugin to display flash files in WordPress.
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?
I disagree. Both the Options Panel and the Portfolio Post Type plugin are optional. The theme works great without them.
Using a custom post type was intentional as it segments the portfolio content from the regular blog content. The plugin makes that data more portable if you ever switch themes.
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.
Did you not see the message when you installed the theme that advised you to install the Portfolio Plugin? There is a hook that enables a plugin to be auto-loaded, but I kind of wanted to leave that choice up to the user.
The argument for not bundling the post type functionality with the theme, is that if you ever switch themes you’re kind of stuck. None of that content would show up or be accessible from the back end. With a plugin, it will stay available no matter what theme you use.
The portfolio functionality was bundled until version 0.8, but I took it out in this most recent version for those portability reasons.
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!
I understand where he is coming from. People are used to having themes bundled with plugin functionality like option panels, short codes, post types and music players. However, it makes more sense to me to put plugin code in plugins and keep the presentation layer inside the theme. It might be a bit more annoying to have to install a couple plugins after the theme is loaded- but it makes the components much easier to upgrade and much more portable overall.
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.
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.
Amazing theme, man! Works like a charm, looks sharp and is relatively easy to work with (particularly considering the other options). Thanks so much for this!
Hi…
Does anyone have any comment as to how well this theme works with a multi-site installation of WordPress?
Looks great!
Thanks.
Is there a way to organize Portfolio Items without editing the “Published On” date?
Thanks, again!
Not at this time.
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,
Robert
Portfolio Press does not support portfolios inside of portfolios. You can have a portfolio item and put a gallery in it. Or you can create portfolio groups using the tags or categories, which can be linked from a page or menu.
Thanks Devin,
I’ve installed File Gallery and it seems to be solving the problem.
Robert
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!
Regards,
Caryn
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
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,
Robert
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!
-Emily
Are you using the latest version- 0.9?
I love your theme: how set websites portfolio like blackframemedia?
And how get complete websites screenshot like http://blackframemedia.com/portfolio/rebecca-hamilton/?
Thanks
You’d need to customize the style.css a bit to get that look.
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.
Hi!
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?
Thanks!
As far as I know, there is no way to make a “new post” appear automatically as a post. You still have to create it and publish it, the same as you would a portfolio post. Or did I completely misunderstand the question? :)
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. :)
Thanks
MB
Yes, that makes much more sense. The newest release of Portfolio Press support post formats- including the image format. I could add a couple more templates in so that “image format” posts are displayed the same as “portfolio” posts if you choose. Let me think through that a little more… but until then, yes, the only way is to create a “portfolio” post.
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.
Thanks!!
Hi Shakira. Fixed! Try the latest version: https://github.com/devinsays/portfolio-press. I’ll release it on .org soon.
Yep that fixed it for me! brill, thanks
Great!! Thank you very much!! :D