How to create a portfolio website in WordPress

Decide what visitors need to see first: your strongest work, the services you offer and how to contact you. A simple structure is Home, Portfolio, About and Contact. Add a separate Blog page only if you plan to publish regularly.

Prepare one title, short summary, project category and selection of images for each project. Keep project names and URL slugs short and permanent. Changing a project URL later can break links and search results.

For a small portfolio, the manual route is fine. Use WordPress Pages for the main sections, add Image, Gallery, Columns and Buttons blocks, and create one page per project. The Gallery block lets you control columns, cropping, image size and click behaviour.

For a larger portfolio, use posts or a portfolio content type supplied by your theme or a plugin. The drawback is extra setup and possible migration work later: if the theme owns the portfolio content type and you change themes, those projects may no longer appear in the same portfolio screen.

Go to Pages > Add New and publish Home, Portfolio, About and Contact. WordPress Pages are intended for non-chronological content such as information about you and your work.

On Home, show your best work and a clear contact button. On Portfolio, either add project links manually or insert a Query Loop on a block theme. A Query Loop can display posts in a grid with featured images, titles, excerpts and pagination.

Create one page or post for each project. Add the project goal, your role, the process, the result and a short list of tools or services used. Set a featured image for every project, because themes and grids commonly use it as the project thumbnail.

Use descriptive image filenames and alternative text. Compress large photographs before uploading them, and check the page on a phone. Do not put every image at full size in one long page; split detailed case studies into sections or separate project pages.

To use a designed Home page instead of the latest posts, go to Settings > Reading, choose A static page, select Home as the homepage and select Blog as the Posts page if you created one. The homepage and Posts page must be different pages.

Add Home, Portfolio, About and Contact to the navigation. Block themes normally manage this in Appearance > Editor with the Navigation block, while classic themes may use Appearance > Menus or the Customizer.

Open the site in a private browser window and test every project card, image, menu item and contact method. Check that the featured image is not missing, text has enough contrast, images are not cropped in a misleading way and the portfolio works on a narrow screen.

If project or portfolio URLs return 404 errors, visit Settings > Permalinks and save the existing structure. Visiting that screen refreshes WordPress rewrite rules, which often fixes newly added content types.

If you want the fast route, start with Calafate rather than assembling every layout yourself. It is designed for creative portfolios and includes grid, masonry and slider layouts, responsive styling, custom header and footer options, and WooCommerce support if you also sell products.

After activating it, import a suitable demo if available, replace the sample content with your own projects, then review typography, colours, mobile spacing and navigation. A pre-built theme saves layout work, but you still need to edit every project and check that the imported pages do not contain unwanted sample text or images.