Portfolio: showcase your projects

The Portfolio app gives your site a project gallery: one page that lists your published projects, filterable by category, plus a page for each project with its images, description and details. It suits work that comes in distinct pieces - shoots, client projects, illustrations, case studies.

Turn it on

1. Open your site in the dashboard and click All Apps in the sidebar.
2. Click Enable next to Portfolio and confirm.

Portfolio now appears in the sidebar. Your portfolio lives at yourname.folio.page/portfolio and each project at /portfolio/project-name.

Add your first project

1. Open Portfolio in the sidebar and click New item.
2. Enter a Title. The URL slug is created from it; click Edit next to the URL if you want a different one.
3. Click Add images and pick images from your media library. The project is saved for you the first time you do this. Drag to reorder; the starred image is the primary one shown in the listing.
4. Add an Excerpt (a short line shown in the listing) and a Description. The description supports Markdown for headings, lists and links.
5. In the Status card, switch on Published and click Save and publish.

Until you publish it, a project is a draft and not visible on your site. Switch on Featured to let a project sort first in the listing. For details such as client, year or tools, click Add field under Custom Fields; a value that is a web address becomes a link on the project page.

Organize your projects

Categories group your projects and power the filter buttons on your portfolio page. Visitors click a category to filter the grid in place; there are no separate category pages.

• Click New category at the bottom of the Portfolio sidebar to create one.
• Pick a project's category in the Category dropdown of the item editor. Projects without one are listed under Uncategorized.
• Hover a category in the sidebar to rename or delete it. Deleting a category moves its projects to Uncategorized; it does not delete them.

On the All Items page you can search, filter by status and switch between grid and list view. With the sort dropdown set to Manual, drag the handle on a project to set the order your visitors see.

View full size

Set up the portfolio page

Open Settings in the Portfolio sidebar. The three settings most people change:

• Base path: the URL prefix, portfolio by default. The page tells you if another page already uses the path.
• Heading Title and Heading Description: the heading at the top of your portfolio page, also used as its search engine title and description.
• Template under Listing page and Detail template: the layout of the grid and the default layout of project pages. A single project can use a different detail layout: switch on Use a different template in its editor.

Intro content, Default sort and Show page heading control the text under the heading, the order projects appear in and whether the heading shows at all. Click Save changes when you are done.

Show projects on other pages

To show your latest projects on your homepage, add a section from the Portfolio category in the page editor. These sections pull from the app automatically, so you never update them by hand. To put the portfolio in your menu, add a menu item with the App link type in Navigation.

Limits per plan

When a site reaches its limit, saving a new project or category shows a message until you upgrade. Templates and custom fields are available on every plan.

Note: An image attached to a project cannot be deleted from the media library while it is in use. Remove it from the project first.