Project Gallery
A project's image gallery, with a lightbox and per-breakpoint columns.
The block renders through the project_gallery element — the same PHP that runs in the page builder, so the front
end is identical either way.
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
| Option | What it does |
|---|---|
project_id | Which project (empty = the current one) |
columns | Columns on desktop |
columns_tablet | Columns on tablet |
columns_mobile | Columns on mobile |
gap | Space between images |
ratio | Crop ratio |
image_size | Which registered image size |
lightbox | Open images in a lightbox |
captions | Show captions |
no_results_text | What to say when the project has no images |
text_color | Text colour |
bg_color | Background |
font_size_preset | Text size preset |
Anything not listed stays available in the page builder, and round-trips untouched.
Leave project_id empty and the element reads whichever project it finds itself in — which is what a
Theme Builder project template wants. Set it, and the
element pins that one project, which is what a landing page wants.
In an ordinary page with neither, there is no project to read, and the block says so rather than rendering nothing.
They are one responsive decision in three parts, and only the desktop one is visible while editing — the same trap as the carousel's.