A reference for every option of the Portfolio block. Options marked (PRO) need WPZOOM Portfolio PRO. The block sidebar has two tabs: Settings (⚙ panels: Filtering, Layout, Fields, Other Settings) and Styles.
Table of Contents
| Option | What it does |
|---|---|
| Portfolio Items Source | Custom Posts (portfolio/blog posts) or Images — a grid built straight from Media Library images, no posts needed (Static Gallery) |
| Post Type | Portfolio Posts or Blog Posts — the block doubles as a stylish blog grid. (PRO) adds any custom post type you enable under Settings → General → Custom Post Types |
| Order By | Default (your custom order) · Newest to Oldest · Oldest to Newest · A → Z · Z → A · Random |
| Categories | Limit the block to one or more portfolio categories (multiple selections allowed) |
| Number of Items | 1–100, default 6 |
| Show Category Filter at the Top | The clickable filter bar. Shown for the Columns/Overlay layouts when at least 2 categories have posts; not available for Masonry or the Images source |
| Load Dynamically New Posts in Each Category | With the filter bar: clicking a category fetches up to Number of Items posts of that category via AJAX, instead of only filtering the ones already on the page |
| Option | What it does |
|---|---|
| Layout Type | Columns — image above, title/meta below · Overlay — title over the image on hover · Masonry — Pinterest-style, keeps original image proportions · Eccentric (PRO) — full-width alternating rows with title, category and excerpt beside the image |
| Dark Mode | Eccentric only: inverts text colors for dark backgrounds |
| Aspect Ratio | Images source only: Original, 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 |
| Amount of Columns | 1–4 (Columns) or 1–6 (Overlay/Masonry) |
| Columns Gap | 0–100 px between items |
| Item Border Radius | Rounds item corners (grid/overlay and masonry) |
| Show View All Button | Adds a button under the grid, with a custom Label (“View All”) and Link — e.g. to a page showing the full portfolio |
The four layouts on the front end:
Columns
Overlay
Masonry
Eccentric (PRO)
| Option | Notes |
|---|---|
| Show Thumbnail + Thumbnail Size | Pick any registered size, including the plugin’s portfolio sizes (grid, masonry, cinema, portrait, square, @2x). Masonry always uses the masonry size |
| Show Title / Hide Title on Hover | Overlay layout can hide the title until hover — or the reverse |
| Show Category | Eccentric layout |
| Show Author / Show Date / Show Excerpt / Show Read More Button (+ label) | Columns layout only |
| Always Play Video Background (PRO) | Autoplays each item’s hover video permanently, like the Inspiro theme’s portfolio (details) |
| Option | What it does |
|---|---|
| Open Portfolio Items in a Lightbox | On by default — clicking an item opens its image (or video) in a full-screen lightbox with prev/next navigation |
| Show Lightbox Caption | Displays the item title under the lightbox image |
| Open Album in Lightbox (PRO) | Items with an Album Gallery show a “View Album” action opening all album images |
| Make Entire Item Clickable | The whole card becomes the link, not just title/image |
| On Item Click | Open Single Portfolio Page or Open Lightbox |
The block also supports the standard WordPress color, typography and spacing controls, and wide/full alignment.
Prefer shortcodes or a non-block builder? Two options:
[wpzoom_block_portfolio] renders a grid with default options (attributes exist for every option above, but they’re easier to manage visually);[wpzoom_portfolio_layout id="…"] anywhere — one place to edit, updated everywhere. See Portfolio Layouts.