Fern docsAll pages

Portfolio

The portfolio is a post type for work worth showing — one project, one photograph, one page. Projects are listed as a grid of images; each one links through to a page of its own.

Write them at Portfolio → Add project in the admin. The featured image is the project image, and it is what the grid shows.

Enable portfolio post type

Customize → Portfolio → Enable portfolio post type, on by default. It adds the Portfolio menu to the admin and shows the grid on the front end. Turning it off hides both without deleting anything.

Portfolio page

Customize → Portfolio → Portfolio page. Pick a page and the grid is built on it, under whatever the page itself says. Leave it unset and the portfolio stays at /projects/.

Setup creates a page called Portfolio and points this setting at it. That page is slugged portfolio, which does not collide with the /projects/ base — but if you slug the page projects yourself you will hit the same redirect loop the notes page can hit. Change one or the other.

Photo ratio

The shape project images are cropped to in the grid:

The uncropped image is always what the project’s own page shows, so this setting is about the tidiness of the grid rather than about the photograph. Original gives a ragged grid, which is the right answer for mixed landscape and portrait work and the wrong one for a neat contact sheet.

Projects per page

How many projects one page of the grid shows before the pagination takes over. Eight is the default, which fills four rows of two.

Exclude projects from search results

On by default — unlike notes, projects are kept out of this site’s own search to begin with, on the reasoning that someone searching a blog is looking for writing. Turn it off to have projects appear in results and in the live-search suggestions. It has no effect on Google.

The URL base

Settings → Permalinks → Portfolio base. Left empty, the grid is at /projects/ and a project is at /project/<slug>/. Set a base and both follow it.