Skip to main content

Portfolio Grid

A filterable grid of portfolio projects — the work index.

The block renders through the portfolio element — the same PHP that runs in the page builder, so the front end is identical either way.

Needs the Portfolio extension

This element ships with the Portfolio extension, which is inactive by default. Activate it under Unyson+ → Extensions and the block appears in the inserter.

With the extension off the block does not register at all — deliberately, so it cannot appear as an inserter entry with an empty sidebar that renders nothing.

What the sidebar exposes

OptionWhat it does
categoriesRestrict to these project categories
countHow many to show
featured_onlyOnly featured projects
orderbySort field
orderAscending or descending
paginationPaginate the grid
link_toWhere a project links
layoutGrid layout
columnsHow many per row
ratioThumbnail crop ratio
hoverHover effect
gapSpace between items
image_sizeWhich registered image size
show_filtersShow category filter buttons
show_summaryShow each project summary
show_categoryShow each project category
text_colorText colour
bg_colorBackground
font_size_presetText size preset

Anything not listed stays available in the page builder, and round-trips untouched.

The query runs for real in the editor

The canvas shows this site's actual projects. What it does not do is filter or paginate: both replace what the grid is showing, so the preview would stop being a preview of the query you are editing.

An empty grid usually means an empty query

No projects yet, or categories narrower than the projects that exist. The block says which rather than rendering nothing.