Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Setup & site building · Guide

How to Build a Portfolio Site With WordPress

How to Build a Portfolio Site With WordPress

Short answer

Build a portfolio site with WordPress by picking a block theme, creating a Work page with block patterns, and adding your best projects as pages or portfolio items. Show 10 to 15 of your strongest pieces, add a short about section and a contact page, then set the portfolio page as your homepage. A portfolio theme, a starter site or Jetpack's portfolio post type can do the same job faster.

Key takeaways

  • A portfolio site shows your skills, experience and past projects so prospective clients can judge your work.
  • Show 10 to 15 of your best pieces; 8 to 12 strong pieces beat 40 average ones.
  • Block patterns give you ready-made portfolio layouts, including grid, grid overlay and split designs.
  • Jetpack's Portfolio post type keeps projects apart from posts and pages, and survives a theme change.
  • Twentig offers starter sites for Twenty Twenty-Five and Twenty Twenty-Four, including a Portfolio starter for Twenty Twenty-Four.

What is the best way to build a portfolio site with WordPress?

Pick a block theme, build the portfolio page with block patterns, and add your best projects as pages or portfolio items.

You do not need code to build a portfolio in WordPress. The block editor gives you galleries, columns and Media and Text blocks, and patterns give you ready-made layouts for project grids. WordPress.com states that you can go from signup to a live portfolio in under an hour, on its portfolio website page.

Three routes cover most sites: build the page by hand with blocks and patterns, use a portfolio theme or starter site, or use a portfolio post type such as Jetpack's.

This guide covers all three so you can pick the one that fits your work. The guide to what a block theme is explains the theme type these routes assume.

What should your portfolio include?

Include your best work, a short about section, a way to contact you, and proof that clients were happy with the work.

A portfolio is a site that shows your skills, experience and past projects so prospective clients can see what you do. WordPress.com defines it this way in its online portfolio guide, which also lists the four parts above as the core of a good portfolio.

Start with an about section that says who you are and what you do in one or two lines. Add a professional photo if you have one, since it helps visitors remember you. Then show your work, and finish with a contact page or form so a visitor can reach you in one click.

Testimonials add trust when you have them. WordPress.com's guide suggests adding client quotes to the portfolio, and Jetpack's portfolio post type also supports a separate Testimonials type for the same job. Keep every piece short: a project needs a title, one image, and two or three lines about what you did.

How many projects should you show?

Show 10 to 15 of your best pieces, not everything you have ever made.

WordPress.com's online portfolio guide gives 10 to 15 as a good rule of thumb, and warns that visitors do not have time to look through every project you ever finished. Its portfolio website page makes the same point with numbers: 8 to 12 strong pieces beat 40 average ones.

Pick pieces that show range and results. A designer might show a logo, a website and a print project; a writer might show three different kinds of writing. Drop old work that no longer shows your current skill, even if you liked it at the time.

Order the projects by strength, with your best piece first. Visitors judge a portfolio in seconds, so the first row of the grid does most of the work. If you have more good work than fits, add a second page or an archive rather than crowding the home page.

How do you plan the portfolio before building?

Decide what you want to be known for, list your best projects, and sketch the pages you need before you open the editor.

WordPress.com's online portfolio guide starts with planning: decide what you want to be known for, then plan the site around that skill. A photographer and a web developer need different pages, even though both build portfolios.

Sketch four pages at most: Home, Work, About and Contact. Home holds your one-line pitch and your best three projects, while Work holds the full grid.

About holds your story and photo. Contact holds a form or an email link.

Gather your files before you build. Resize images to a sane width, write one short description per project, and collect client quotes. Building goes much faster when the content is ready, and the guide to backing up WordPress is worth reading before you start changing a live site.

How do you build a portfolio page with blocks and patterns?

Create a page called Work, add a Gallery or Columns block for the grid, and use a block pattern for the layout.

Block patterns are pre-designed layouts you can insert from the block inserter and then swap your own content into.

Twentig, a free plugin in the WordPress.org directory, ships portfolio patterns in grid, grid overlay and split layouts, according to its plugin page. Pick one pattern per page section and change the design in a single click.

Build the grid with Columns blocks when each project needs an image, a title and a short line of text. Use a Gallery block when the images should speak for themselves, such as photography. Use Media and Text blocks for case studies, where one image sits next to a longer description.

You can copy a pattern's block code from the editor's Options menu with Copy all blocks, as WordPress's developer docs explain in the Introduction to Patterns. That lets you move a layout you like from one page to another without rebuilding it.

Link each grid item to its own project page. Give every project page a featured image, a title, and a short write-up of the brief, your role and the result. The guide to using the WordPress Site Editor covers the editor screens used for this work.

How do you build it with a portfolio theme or starter site?

Install a theme built for portfolios, or import a starter site, then replace its sample content with your own work.

A portfolio theme ships with project grids, filterable galleries and project pages already designed. Search the theme directory for “portfolio” and look for themes with dedicated project pages and grid or masonry layouts. WordPress.com's online portfolio guide lists choosing a portfolio theme as one of its six build steps.

Starter sites go further: they import a full demo site you then edit.

Twentig offers starter sites for the Twenty Twenty-Five theme, including Business, News Blog, Photo Blog and Personal Blog, and for Twenty Twenty-Four, including Business, Blog, Personal and Portfolio, as its plugin page states. Import the Portfolio starter, then swap in your images and text.

Check the theme's demo before you commit. A theme that looks right with its demo images can look empty with your content, so compare the demo's project count with yours. The guide to block themes versus classic themes helps you pick a theme type before you install one.

RouteBest forWhat you getEffort
Blocks and patternsSmall portfolios, full controlGallery, Columns and pattern layoutsA few hours
Portfolio themeA designed look with little setupProject grids and project pages built inUnder an hour to start
Starter siteA full demo to editWhole site imported, then customisedUnder an hour to start
Jetpack portfolio post typeMany projects to manageProjects as a content type with types and tagsAn hour plus content time

How do you add projects with Jetpack's portfolio post type?

Enable Portfolios under Jetpack, then Settings, then Writing, and add each project as a portfolio item with a featured image.

Jetpack adds a Portfolio custom post type that keeps your projects in one place, apart from posts and pages. Jetpack's Custom Content Types support page says to go to Jetpack, then Settings, then Writing, and turn on the Portfolio option under Custom Content Types.

Once it is on, a Portfolio menu appears in your dashboard. Add a project the same way you add a post: title, content, featured image, plus a project type and tags to group similar work. Jetpack states that you can show the portfolio with the `[

portfolio]` shortcode on a page, or by adding a link to it in your site menu.

One limit applies to block themes. In recent Jetpack versions, starting with Jetpack 14.4, the Portfolios and Testimonials settings do not show their settings screen in block themes such as Twenty Twenty-Four. Jetpack's Custom Content Types page says this is expected, and that block theme sites should use block patterns to show portfolios instead.

Because Jetpack owns the post type, your projects survive a theme change. That matters if you plan to redesign later: switching themes will not delete the portfolio items, only change how they look.

How do you set the homepage and menu?

Set a static front page to your portfolio home, and add Work, About and Contact to your main menu.

Go to Settings, then Reading, and choose a static page for your homepage. Pick the page you built as the portfolio home, and pick a different page for your posts if you run a blog. The guide to changing the homepage in WordPress walks through these settings.

Add the pages to your menu so visitors can reach them from any page. In a classic theme this happens under Appearance, then Menus; in a block theme it happens in the Navigation block. Keep the menu short: Home, Work, About and Contact cover almost every portfolio.

Check the menu on a phone as well as a desktop. Portfolio visitors often arrive from a phone, and a menu that wraps badly on a small screen hides the Work link they came for. The guide to adding custom CSS in WordPress covers small style fixes if a menu item needs one.

How do you keep the portfolio fast and fresh?

Compress images before upload, show your best work first, and add new projects as you finish them.

Images are the main weight on a portfolio page. Resize each image to the size it shows at, and compress it before upload, since a full-size camera file slows every visit. WordPress.com's portfolio website page notes that WordPress.com handles hosting and updates for you, but image size is still your job on any host.

Update the portfolio when you finish strong work. WordPress.com's online portfolio guide asks how often you should update, and the answer is whenever you have a better piece than the weakest one on display. Swap the weakest piece out rather than adding a new row each time.

Keep a backup before big changes. A portfolio holds your best work, so losing it costs more than losing a blog post.

What mistakes should you avoid?

Do not show everything, do not skip the contact page, and do not leave the portfolio frozen for years.

These mistakes weaken most portfolios:

  • Showing every project you ever finished, which buries your best work under average work.
  • Hiding the contact link, so an interested visitor has no way to reach you.
  • Using low-quality or stretched images, which tell visitors more than any text can.
  • Writing long case studies nobody reads, instead of a title, an image and three lines.
  • Leaving the portfolio untouched for years, so it shows skills you have outgrown.
  • Forgetting a backup before a redesign, and losing project pages in the change.

Review the portfolio once a quarter. Open it on a phone, click every project link, and check that each image loads.

Remove the weakest piece, add your newest strong piece, and confirm the contact page still works. A small, current portfolio earns more work than a large, stale one.

Frequently asked questions

Do I need a plugin to build a portfolio in WordPress?

No. The block editor alone can build a portfolio page with Gallery, Columns and Media and Text blocks plus block patterns. A plugin helps when you want more: Jetpack adds a Portfolio post type for managing many projects, and Twentig adds starter sites and portfolio patterns. Start with blocks, and add a plugin only when the manual route feels slow.

What is the difference between a portfolio theme and a starter site?

A portfolio theme gives you the design, such as project grids and project pages, and you add your own content to it. A starter site imports a whole demo site, including sample pages and layouts, which you then edit and replace with your work. Themes suit a fresh build, while starter sites suit people who want a finished look to edit.

How do I add a project to my portfolio?

Create a page for the project with a title, a featured image and a short write-up of the brief, your role and the result. Then link to it from your Work page grid so visitors can open it. If you use Jetpack's Portfolio post type, add the project there instead, and show it with the portfolio shortcode or a menu link.

Should my portfolio be one page or several pages?

Either works. A single page suits a small body of work, since visitors can scan it fast. Several pages suit varied work, with a Work page holding the grid and a separate page for each project. Start with one page and expand to project pages when you have more than a few pieces worth showing in detail.

How often should I update my portfolio?

Update it whenever you finish a piece stronger than the weakest one on display, and review it once a quarter. Swap the weakest piece out rather than adding a new row each time, so the portfolio stays tight. Check every link and image on a phone during the review, since many visitors arrive from mobile.

Sources

  1. How to Create an Online Portfolio Website to Share Your Work WordPress.com
  2. How to Make a Portfolio Website (Free) WordPress.com
  3. Custom Content Types in Jetpack Jetpack
  4. Twentig – Toolkit for Block Theme WordPress.org
  5. Introduction to Patterns WordPress Developer Resources

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.