Reference
Page Builder Sandwich blocks reference
Every block of Page Builder Sandwich and Page Builder Sandwich Pro (44 free, 68 Pro): its name for code and AI agents, what it does, and each attribute with its type and default, read from the plugin’s own block.json files.
Layout and design
Animated text pbs/animated-text
Pro. A paragraph or heading that types itself out, or whose words fade or rise in, when it scrolls into view. Still for visitors who ask for less motion. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
content | string | "" | — |
tag | string | "p" | p h2 h3 h4 h5 h6 |
effect | string | "fade" | typewriter fade rise |
speed | string | "normal" | slow normal fast |
Editor supports: interactivity.
Button link pbs/button
Free. A link styled as a button. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
url | string | "" | — |
text | string | "" | — |
style | string | "" | — |
target | string | "" | _blank |
rel | string | "" | — |
align | string | "" | left center right |
wrapStyle | string | "" | — |
wrapped | boolean | false | — |
wrapData | object | — | — |
legacyClass | string | "" | — |
legacyData | object | — | — |
legacy | boolean | false | — |
Container pbs/container
Free. A box that lays out the blocks inside it with flexbox or a grid. Nest containers to build any layout. Stays readable if the plugin is ever turned off. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
tag | string | "div" | section div header footer article aside main nav |
width | string | "full" | full boxed |
link | object | — | — |
Cursor effects pbs/cursor-effects
Pro. A ring, a spotlight or a short trail that follows the mouse pointer over a section, or over the whole page. Off on touch screens and for visitors who ask for less motion. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
effect | string | "ring" | ring spotlight trail |
scope | string | "section" | section page |
Editor supports: interactivity.
Language switcher pbs/language-switcher
Free. Lets visitors read this page in another language, styled to match your page. Needs the Tranzly plugin for the languages. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
design | string | "pills" | list pills buttons dropdown codes |
display | string | "name" | name code name_code |
flags | boolean | false | — |
flagShape | string | "" | rectangle rounded square circle |
flagSize | string | "" | medium small large |
showCurrent | boolean | true | — |
hideMissing | boolean | false | — |
vertical | boolean | false | — |
label | string | "" | — |
vars | object | {} | — |
Marquee pbs/marquee
Pro. A line of short texts that scrolls across the page, with a pause button. Still for visitors who ask for less motion. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
label | string | "" | — |
separator | string | "dot" | dot slash star none |
speed | string | "normal" | slow normal fast |
direction | string | "start" | start end |
Editor supports: interactivity.
Particles background pbs/particles
Pro. A section with slowly drifting dots behind its blocks. One still frame for visitors who ask for less motion. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
color | string | "" | — |
density | string | "normal" | low normal high |
speed | string | "normal" | slow normal fast |
links | boolean | true | — |
Editor supports: interactivity.
Row pbs/row
Free. A row of columns. Stays readable if the plugin is ever turned off. See it working.
Inner blocks: Column.
| Attribute | Type | Default | Values |
|---|---|---|---|
style | string | "" | — |
width | string | "" | full-width full-width-retain-content |
legacyClass | string | "" | — |
legacyData | object | — | — |
legacy | boolean | false | — |
Section pbs/section
Free. A full-width band of the page that lays its content out with flexbox or a grid. Stays readable if the plugin is ever turned off. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
tag | string | "section" | section div header footer article aside main nav |
width | string | "boxed" | full boxed |
align | string | "full" | — |
link | object | — | — |
Editor supports: align.
Content
Accordion pbs/accordion
Free. Questions or sections that open and close. Optionally one at a time, and optionally marked up as an FAQ for search engines. See it working.
Inner blocks: Accordion item.
| Attribute | Type | Default | Values |
|---|---|---|---|
single | boolean | false | — |
faq | boolean | false | — |
Alert pbs/alert
Free. A notice for your visitors: information, success, a warning or an error, with an optional title and a close button. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
variant | string | "info" | info success warning error |
title | string | "" | — |
content | string | "" | — |
showIcon | boolean | true | — |
dismissible | boolean | false | — |
Editor supports: interactivity.
Badge pbs/badge
Free. A short label such as New, Sale or Best value. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
content | string | "" | — |
variant | string | "accent" | neutral info success warning error accent |
justify | string | "start" | start center end |
Checklist pbs/checklist
Free. A list of tasks, each marked done or still to do, in words for screen readers as well as with a tick. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
accent | string | "primary" | text primary secondary contrast |
Content switcher pbs/content-switcher
Pro. A switch between two or more versions of some content, such as monthly and yearly prices. See it working.
Inner blocks: Switcher pane.
| Attribute | Type | Default | Values |
|---|---|---|---|
label | string | "" | — |
Dual heading pbs/dual-heading
Free. A heading in two parts, the second one accented with a colour, a gradient, an outline or an underline. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
first | string | "" | — |
second | string | "" | — |
level | integer | 2 | — |
look | string | "accent" | accent gradient outline underline |
stacked | boolean | false | — |
justify | string | "start" | start center end |
Feature list pbs/feature-list
Free. Features in a grid, each with an icon, a heading and a short description. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
icon | string | "check" | check star info arrow dot circle |
columns | integer | 3 | — |
level | integer | 2 | — |
accent | string | "primary" | text primary secondary contrast |
Glossary pbs/glossary
Free. Terms and their definitions, sorted A to Z, each with its own link. Can link the first mention of each term on the page to its definition. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
sort | boolean | true | — |
showIndex | boolean | false | — |
autoLink | boolean | false | — |
Icon list pbs/icon-list
Free. A list where every line starts with an icon: a check mark, an arrow, or any icon from the library. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
icon | string | "check" | check dot arrow star circle |
layout | string | "stacked" | stacked inline |
accent | string | "primary" | text primary secondary contrast |
Info box pbs/info-box
Free. An icon, a short heading, a sentence or two and an optional link: for services, benefits or contact details. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
svg | string | "" | — |
iconRef | string | "" | — |
icon | string | "info" | info star check arrow dot circle |
showIcon | boolean | true | — |
title | string | "" | — |
content | string | "" | — |
linkUrl | string | "" | — |
linkText | string | "" | — |
newTab | boolean | false | — |
align | string | "start" | start center |
level | integer | 2 | — |
accent | string | "primary" | text primary secondary contrast |
Modal pbs/modal
Free. A button that opens a window over the page, with any blocks inside. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
trigger | string | "" | — |
title | string | "" | — |
size | string | "medium" | small medium large |
backdropClose | boolean | true | — |
Off-canvas panel pbs/off-canvas
Free. A button that slides a panel in from the side of the window, with any blocks inside. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
trigger | string | "" | — |
title | string | "" | — |
side | string | "end" | start end |
backdropClose | boolean | true | — |
Posts pbs/posts
Pro. Posts, pages, portfolio items or products as cards: grid, list, masonry or carousel, with a category filter and pages or “Load more”. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
layout | string | "grid" | grid list masonry carousel |
columns | integer | 3 | — |
postType | string | "post" | — |
perPage | integer | 6 | — |
categories | array | [] | — |
orderBy | string | "date" | date title modified menu_order rand |
order | string | "DESC" | DESC ASC |
showImage | boolean | true | — |
showDate | boolean | true | — |
showExcerpt | boolean | true | — |
showTerms | boolean | false | — |
showPrice | boolean | true | — |
level | integer | 2 | — |
filter | boolean | false | — |
pagination | string | "none" | none numbers more |
autoplay | boolean | false | — |
interval | integer | 5 | — |
loop | boolean | true | — |
arrows | boolean | true | — |
dots | boolean | true | — |
Show more pbs/show-more
Pro. Long content cut to a set height, with a button that shows the rest. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
height | string | "medium" | small medium large |
moreLabel | string | "" | — |
lessLabel | string | "" | — |
Steps pbs/steps
Free. The numbered steps of a process, in order, down the page or side by side. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
layout | string | "vertical" | vertical horizontal |
level | integer | 2 | — |
accent | string | "primary" | text primary secondary contrast |
Tabs pbs/tabs
Free. Content in tabs: visitors switch between panels by mouse or keyboard. See it working.
Inner blocks: Tab.
| Attribute | Type | Default | Values |
|---|---|---|---|
label | string | "" | — |
vertical | boolean | false | — |
selected | integer | 0 | — |
Tooltip pbs/tooltip
Free. A word or phrase that shows a short explanation on hover and keyboard focus. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
text | string | "" | — |
tip | string | "" | — |
placement | string | "top" | top bottom |
Marketing and sales
A/B test pbs/ab-test
Pro. Two versions of a section: each visitor sees one, and the A/B tests screen shows which converts better. See it working.
Inner blocks: A/B version.
| Attribute | Type | Default | Values |
|---|---|---|---|
testId | string | "" | — |
name | string | "" | — |
split | number | 50 | — |
goal | string | "" | — |
Animated headline pbs/animated-headline
Pro. A heading whose key word changes, with a pause button and no motion for visitors who ask for less. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
before | string | "" | — |
words | array | [] | — |
after | string | "" | — |
effect | string | "fade" | fade slide type |
level | integer | 2 | — |
interval | integer | 2500 | — |
Editor supports: interactivity.
Before and after pbs/before-after
Pro. Two images on top of each other with a slider to compare them. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
beforeUrl | string | "" | — |
beforeId | integer | 0 | — |
beforeAlt | string | "" | — |
beforeLabel | string | "" | — |
afterUrl | string | "" | — |
afterId | integer | 0 | — |
afterAlt | string | "" | — |
afterLabel | string | "" | — |
position | integer | 50 | — |
Editor supports: interactivity.
Call to action pbs/call-to-action
Free. A heading, a sentence and one or two buttons that ask the visitor to act. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
title | string | "" | — |
content | string | "" | — |
level | integer | 2 | — |
primaryText | string | "" | — |
primaryUrl | string | "" | — |
primaryNewTab | boolean | false | — |
secondaryText | string | "" | — |
secondaryUrl | string | "" | — |
secondaryNewTab | boolean | false | — |
layout | string | "stacked" | stacked split |
align | string | "center" | start center |
Click to share quote pbs/click-to-tweet
Pro. A quote with a button that opens a post on X with the quote and a link to this page. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
quote | string | "" | — |
via | string | "" | — |
url | string | "" | — |
buttonText | string | "" | — |
Comparison table pbs/comparison-table
Free. Plans or products side by side, with yes and no marks that screen readers read as words. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
caption | string | "" | — |
columns | array | [] | — |
rows | array | [] | — |
stickyHeader | boolean | false | — |
onlyDifferences | boolean | false | — |
Contact buttons pbs/contact-buttons
Free. Buttons to call, email, text or message you on WhatsApp. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
message | string | "" | — |
Countdown pbs/countdown
Pro. A timer counting down to a date, or an evergreen countdown that starts when each visitor first arrives. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
mode | string | "date" | date evergreen |
date | string | "" | — |
evergreenHours | integer | 24 | — |
label | string | "" | — |
expiredText | string | "" | — |
showSeconds | boolean | true | — |
Editor supports: interactivity.
Counter pbs/counter
Pro. A number that counts up when it comes into view, with a label. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
start | number | 0 | — |
end | number | 100 | — |
decimals | integer | 0 | — |
duration | integer | 2000 | — |
prefix | string | "" | — |
suffix | string | "" | — |
label | string | "" | — |
separator | boolean | true | — |
Editor supports: interactivity.
Coupon code pbs/coupon-code
Pro. A discount code that visitors reveal and copy with one click. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
code | string | "" | — |
description | string | "" | — |
buttonText | string | "" | — |
expires | string | "" | — |
Editor supports: interactivity.
Flip box pbs/flip-box
Pro. A card that turns over to show more: on hover, on keyboard focus, or with its own button on touch screens. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
svg | string | "" | — |
iconRef | string | "" | — |
frontTitle | string | "" | — |
frontText | string | "" | — |
backTitle | string | "" | — |
backText | string | "" | — |
buttonText | string | "" | — |
buttonUrl | string | "" | — |
effect | string | "flip" | flip fade |
level | integer | 2 | — |
Editor supports: interactivity.
Form pbs/form
Free. Shows a form from Contact Form 7, WPForms, Gravity Forms or Fluent Forms, styled to match your site. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
provider | string | "" | cf7 wpforms gravityforms fluentforms |
formId | string | "" | — |
fieldStyle | string | "outlined" | outlined filled underlined |
buttonWidth | string | "auto" | auto full |
Form pbs/form-builder
Pro. A contact, quote, signup or multi-step form with spam protection, file uploads and conditional fields; each submission can be emailed, saved, sent to a webhook or added to a mailing list. See it working.
Inner blocks: Form field, Form step.
| Attribute | Type | Default | Values |
|---|---|---|---|
formId | string | "" | — |
title | string | "" | — |
submitText | string | "" | — |
successMessage | string | "" | — |
redirectUrl | string | "" | — |
trackEvent | string | "" | — |
actions | object | {} | — |
Hotspots pbs/hotspots
Pro. An image with points that open a short note when chosen. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
imageUrl | string | "" | — |
imageId | integer | 0 | — |
imageAlt | string | "" | — |
points | array | [] | — |
Editor supports: interactivity.
Logo grid pbs/logo-grid
Pro. Client or partner logos in a grid, each with an optional link. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
logos | array | [] | — |
columns | integer | 4 | — |
grayscale | boolean | true | — |
Logo marquee pbs/logo-marquee
Pro. Logos scrolling slowly across, with a pause button; still for visitors who ask for less motion. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
logos | array | [] | — |
speed | string | "normal" | slow normal fast |
grayscale | boolean | true | — |
Editor supports: interactivity.
Lottie animation pbs/lottie
Pro. A Lottie animation from a file you upload, played on this site with no outside request. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
fileId | integer | 0 | — |
fileName | string | "" | — |
label | string | "" | — |
loop | boolean | true | — |
play | string | "view" | view load hover |
speed | number | 1 | — |
Editor supports: interactivity.
Newsletter signup pbs/newsletter
Pro. An email signup form for Mailchimp, MailPoet or AWeber, with a consent checkbox and a clear message on success or failure. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
service | string | "mailpoet" | mailpoet mailchimp aweber |
list | string | "" | — |
heading | string | "" | — |
text | string | "" | — |
buttonText | string | "" | — |
consentText | string | "" | — |
successText | string | "" | — |
layout | string | "stacked" | stacked inline |
Editor supports: interactivity.
Price list pbs/price-list
Pro. Items with a name, a price and a short description, such as a menu or a list of services. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
Pricing table pbs/pricing-table
Pro. Plans side by side with their price, features and a button, with an optional monthly / yearly switch. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
plans | array | [] | — |
billingToggle | boolean | false | — |
currency | string | "$" | — |
monthlyLabel | string | "" | — |
yearlyLabel | string | "" | — |
yearlyNote | string | "" | — |
level | integer | 2 | — |
Editor supports: interactivity.
Promo bar pbs/promo-bar
Pro. A slim announcement bar that stays at the top or bottom of the screen, which visitors can close. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
content | string | "" | — |
linkText | string | "" | — |
linkUrl | string | "" | — |
newTab | boolean | false | — |
position | string | "top" | top bottom inline |
dismissible | boolean | true | — |
variant | string | "dark" | dark accent light |
Editor supports: interactivity.
Recent sales notices pbs/social-proof
Pro. Small notices of real recent orders from WooCommerce or Easy Digital Downloads: the buyer’s first name and city, only for buyers who agreed at checkout. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
source | string | "auto" | auto woocommerce edd |
count | integer | 10 | — |
maxAgeDays | integer | 14 | — |
showFor | integer | 6 | — |
gap | integer | 12 | — |
position | string | "start" | start end |
showProduct | boolean | true | — |
showTime | boolean | true | — |
Editor supports: interactivity.
Share bar pbs/share-bar
Pro. Buttons to share this page on social networks, by email, by the device’s own share menu, or by copying the link. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
networks | array | [] | — |
layout | string | "inline" | inline floating |
label | string | "" | — |
Editor supports: interactivity.
Social icons pbs/social-icons
Free. Links to your profiles, drawn with the networks’ own icons. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
look | string | "filled" | plain filled outline |
shape | string | "circle" | circle rounded square |
size | string | "medium" | small medium large |
justify | string | "start" | start center end |
newTab | boolean | true | — |
Team pbs/team
Pro. People with their photo, name, role, a short bio and links. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
members | array | [] | — |
columns | integer | 3 | — |
level | integer | 2 | — |
Testimonial pbs/testimonial
Free. A quote from a customer with their name, role, photo and an optional star rating. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
quote | string | "" | — |
name | string | "" | — |
role | string | "" | — |
imageUrl | string | "" | — |
imageId | integer | 0 | — |
imageAlt | string | "" | — |
rating | integer | 0 | — |
layout | string | "stacked" | stacked side |
align | string | "start" | start center |
Timeline pbs/timeline
Pro. Events in order with their dates, down a line. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
level | integer | 2 | — |
Trust badges pbs/trust-badges
Pro. Short reassurances with an icon each: secure payment, free delivery, easy returns. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
badges | array | [] | — |
layout | string | "row" | row grid |
WhatsApp chat button pbs/whatsapp
Free. A floating button in a corner of the page that opens a WhatsApp chat with you. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
phone | string | "" | — |
message | string | "" | — |
label | string | "" | — |
showLabel | boolean | false | — |
position | string | "end" | end start |
Images, video and media
3D model viewer pbs/model-viewer
Pro. A 3D model (glTF or GLB) visitors can turn and zoom, optionally in augmented reality. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
src | string | "" | — |
alt | string | "" | — |
poster | string | "" | — |
autoRotate | boolean | false | — |
ar | boolean | false | — |
Audio player pbs/audio-player
Pro. A podcast or music player: episodes, artwork and playback speed around the browser’s own player. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
tracks | array | [] | — |
title | string | "" | — |
artwork | object | — | — |
Booking calendar pbs/booking
Free. A Calendly or Cal.com booking calendar, loaded only when the visitor asks for it. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
provider | string | "calendly" | calendly cal |
url | string | "" | — |
label | string | "" | — |
Editor supports: interactivity.
Gallery pbs/gallery
Pro. Images in a masonry, justified or even grid, opening in an accessible lightbox. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
images | array | [] | — |
layout | string | "masonry" | masonry justified grid |
columns | integer | 3 | — |
lightbox | boolean | true | — |
captions | boolean | false | — |
Icon pbs/icon
Free. An SVG icon. The markup is cleaned before it is shown. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
svg | string | "" | — |
style | string | "" | — |
iconRef | string | "" | — |
display | string | — | inline block |
justify | string | "start" | start center end |
label | string | "" | — |
Image accordion pbs/image-accordion
Pro. Image panels side by side; the one under the pointer or keyboard widens to show its text. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
Map pbs/map
Free. A map of a place from OpenStreetMap: no key, and nothing loads from OpenStreetMap until the visitor asks for the map. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
lat | number | — | — |
lng | number | — | — |
zoom | number | 14 | — |
label | string | "" | — |
Editor supports: align, interactivity.
Parallax image pbs/parallax-image
Pro. An image that drifts as the page scrolls. Still for visitors who prefer less motion. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
image | object | — | — |
strength | string | "medium" | low medium high |
height | string | "medium" | small medium large |
PDF viewer pbs/pdf-viewer
Pro. A PDF shown on the page by the browser, with a link to open it. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
src | string | "" | — |
title | string | "" | — |
height | string | "medium" | small medium large |
QR code pbs/qr-code
Free. A QR code for a web address or any text, drawn on your own site (no QR service is used). See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
text | string | "" | — |
svg | string | "" | — |
alt | string | "" | — |
caption | string | "" | — |
Slider pbs/slider
Pro. A carousel of slides, images, posts or products: swipe, buttons or automatic, and accessible. See it working.
Inner blocks: Slide.
| Attribute | Type | Default | Values |
|---|---|---|---|
label | string | "" | — |
source | string | "slides" | slides images posts products |
images | array | [] | — |
postType | string | "post" | — |
perPage | integer | 6 | — |
categories | array | [] | — |
orderBy | string | "date" | date title modified menu_order rand |
order | string | "DESC" | DESC ASC |
showImage | boolean | true | — |
showDate | boolean | true | — |
showExcerpt | boolean | true | — |
showTerms | boolean | false | — |
showPrice | boolean | true | — |
effect | string | "slide" | slide fade kenburns |
perView | integer | 1 | — |
perViewTablet | integer | 1 | — |
perViewMobile | integer | 1 | — |
autoplay | boolean | false | — |
interval | integer | 5 | — |
loop | boolean | true | — |
arrows | boolean | true | — |
dots | boolean | true | — |
Video gallery pbs/video-gallery
Pro. A grid of videos. YouTube and Vimeo load only when a visitor presses play, with posters kept on your site. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
videos | array | [] | — |
columns | integer | 3 | — |
Video playlist pbs/video-playlist
Pro. One player and a list of videos: your own files, or YouTube and Vimeo loaded only when chosen. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
videos | array | [] | — |
label | string | "" | — |
Data, charts and tables
Chart pbs/chart
Pro. A bar, line or pie chart drawn on the server, with the numbers in a table for everyone who cannot see the chart. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
type | string | "bar" | bar line pie |
title | string | "" | — |
labels | array | [] | — |
series | array | [] | — |
valuePrefix | string | "" | — |
valueSuffix | string | "" | — |
height | string | "medium" | short medium tall |
showLegend | boolean | true | — |
showValues | boolean | false | — |
Code pbs/code
Free. A code listing with syntax highlighting, line numbers and a copy button. Stays readable if the plugin is ever turned off. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
code | string | "" | — |
language | string | "auto" | — |
filename | string | "" | — |
lineNumbers | boolean | false | — |
copy | boolean | true | — |
wrap | boolean | false | — |
Editor supports: interactivity.
Data table pbs/data-table
Pro. A table visitors can sort and search, that stays readable on a phone. Paste or import a CSV file. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
caption | string | "" | — |
columns | array | [] | — |
rows | array | [] | — |
sortable | boolean | true | — |
searchable | boolean | true | — |
layout | string | "stack" | stack scroll |
striped | boolean | true | — |
rowHeaders | boolean | false | — |
Editor supports: interactivity.
Events pbs/events
Pro. Upcoming events as a list or a month calendar, in the site’s time zone. Past events leave the list by themselves. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
events | array | [] | — |
view | string | "list" | list calendar |
showPast | boolean | false | — |
source | string | "manual" | manual tec |
tecCategory | string | "" | — |
limit | number | 20 | — |
categories | array | [] | — |
hideCanceled | boolean | false | — |
hidePostponed | boolean | false | — |
Editor supports: interactivity.
Google and Trustpilot reviews pbs/reviews
Pro. Your Google and Trustpilot reviews as a grid, a slider or a badge. Refreshed once a day in the background, so pages never wait for either service. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
source | string | "both" | both google trustpilot |
layout | string | "grid" | grid slider badge |
minRating | integer | 4 | — |
order | string | "newest" | newest best |
count | integer | 6 | — |
showDate | boolean | true | — |
showSummary | boolean | false | — |
label | string | "" | — |
Editor supports: interactivity.
Org chart pbs/org-chart
Pro. Who reports to whom, as a tree of people with their roles and photos. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
label | string | "" | — |
people | array | [] | — |
Progress bar pbs/progress-bar
Free. A labelled bar that shows how far something has come, such as a skill or a goal. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
label | string | "" | — |
value | integer | 50 | — |
max | integer | 100 | — |
showValue | boolean | true | — |
Progress circle pbs/progress-circle
Pro. A ring that fills to a value, with the number and a label as real text. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
value | number | 75 | — |
max | number | 100 | — |
label | string | "" | — |
format | string | "percent" | percent value |
size | string | "medium" | small medium large |
thickness | string | "normal" | thin normal thick |
Query loop pbs/query-loop
Pro. List posts, products, users, categories or a repeater field, filtered and sorted, with a card you design once. Optional live filters and pages. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
loopId | string | "" | — |
source | string | "posts" | posts users terms field |
postType | string | "post" | — |
inherit | boolean | false | — |
terms | array | [] | — |
metaKey | string | "" | — |
metaValue | string | "" | — |
metaCompare | string | "=" | = != > >= < <= LIKE EXISTS NOT EXISTS |
orderBy | string | "date" | — |
orderMetaKey | string | "" | — |
order | string | "DESC" | DESC ASC |
perPage | integer | 6 | — |
offset | integer | 0 | — |
excludeCurrent | boolean | false | — |
taxonomy | string | "category" | — |
hideEmpty | boolean | true | — |
fieldProvider | string | "meta" | — |
fieldKey | string | "" | — |
columns | integer | 3 | — |
layout | string | "grid" | grid list |
pagination | string | "none" | none numbers prevnext |
filters | array | [] | — |
filterPosition | string | "top" | top start |
live | boolean | true | — |
noResults | string | "" | — |
Editor supports: interactivity.
Roadmap pbs/roadmap
Pro. What is planned, in progress and done, as a board of three columns or as one list. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | [] | — |
layout | string | "board" | board list |
headingLevel | integer | 2 | — |
Star rating pbs/star-rating
Free. A rating shown as stars, in half-star steps. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
rating | number | 4 | — |
max | integer | 5 | — |
showValue | boolean | false | — |
Site building and navigation
Author box pbs/author-box
Pro. The author of this post: photo, name, biography and links. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
showAvatar | boolean | true | — |
showBio | boolean | true | — |
showPosts | boolean | true | — |
showWebsite | boolean | true | — |
avatarSize | number | 96 | — |
headingLevel | string | "h2" | — |
Author profile pbs/user-profile
Free. The author’s picture, name, bio and links, or those of a chosen user. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
source | string | "author" | author user |
userId | number | 0 | — |
showAvatar | boolean | true | — |
showBio | boolean | true | — |
showLinks | boolean | true | — |
Back to top pbs/back-to-top
Pro. A button in the corner of the screen that takes the visitor back to the top of the page. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
label | string | "" | — |
position | string | "end" | — |
showAfter | number | 400 | — |
showLabel | boolean | false | — |
Editor supports: interactivity.
Breadcrumbs pbs/breadcrumbs
Pro. The path from the home page to this page, with structured data for search engines. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
showHome | boolean | true | — |
homeLabel | string | "" | — |
separator | string | "chevron" | — |
showCurrent | boolean | true | — |
schema | boolean | true | — |
Business hours pbs/business-hours
Pro. Your opening hours for the week, with an “Open now” line worked out in your site’s time zone. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
title | string | "" | — |
days | array | [{"closed":true,"ranges":[]},{"closed… | — |
showOpenNow | boolean | true | — |
highlightToday | boolean | true | — |
note | string | "" | — |
Editor supports: interactivity.
Dark mode switch pbs/dark-mode-switch
Pro. A button that switches the website between its light and dark colours, and remembers the visitor’s choice. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
label | string | "" | — |
showLabel | boolean | false | — |
Editor supports: interactivity.
Login and register pbs/login-form
Pro. The WordPress login or registration form, and a logout link once signed in. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
mode | string | "login" | — |
redirect | string | "" | — |
showRemember | boolean | true | — |
showLost | boolean | true | — |
showRegister | boolean | true | — |
Mini cart pbs/mini-cart
Pro. The visitor’s cart count and total, opening the items in the cart. Stays current after an add to cart, even on a cached page. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
label | string | "" | — |
Navigation menu pbs/nav-menu
Free. A WordPress menu with dropdowns and a mobile menu: a side drawer, a full-screen menu or a dropdown. Mega menus with Pro. See it working.
Inner blocks: Mega menu panel (Pro).
| Attribute | Type | Default | Values |
|---|---|---|---|
menuId | number | 0 | — |
orientation | string | "horizontal" | horizontal vertical |
collapse | string | "mobile" | mobile tablet always never custom |
openOn | string | "click" | click hover |
label | string | "" | — |
breakpoint | number | 900 | — |
mobileStyle | string | "drawer" | drawer fullscreen dropdown |
drawerSide | string | "end" | end start |
toggleIcon | string | "menu" | menu menu-alt grid none |
toggleLabel | string | "" | — |
toggleShowLabel | boolean | true | — |
toggleStyle | string | "outline" | outline solid plain |
closeOnLink | boolean | true | — |
mobileSubmenus | string | "collapsed" | collapsed expanded |
closeDelay | number | 150 | — |
animation | string | "fade" | none fade slide |
skipLink | boolean | false | — |
skipTarget | string | "main" | — |
Editor supports: interactivity.
Password-protected content pbs/protected
Free. Blocks only visitors with the password can see. Until they enter it, the content is not in the page at all. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
lockId | string | "" | — |
hash | string | "" | — |
message | string | "" | — |
Post details pbs/post-meta
Free. The post’s author, dates, categories, tags, reading time and comment count. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
items | array | ["author","date","readingTime"] | — |
Product element pbs/product-element
Pro. One part of a product: its title, gallery, price, rating, add to cart, tabs, related products, upsells, sale badge or stock. Shows the product being viewed, the loop’s product or one you choose. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
part | string | "title" | title gallery image price rating excerpt description add_to_cart meta tabs related upsells sale_badge stock |
productId | integer | 0 | — |
level | integer | 0 | — |
Reading progress bar pbs/reading-progress
Free. A thin bar at the edge of the window that fills as visitors scroll through the page. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
position | string | "top" | top bottom |
Reading time pbs/reading-time
Pro. How many minutes this post takes to read. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
wpm | number | 200 | — |
format | string | "long" | — |
prefix | string | "" | — |
Related posts pbs/related-posts
Free. Posts that share this post’s categories or tags, with their pictures, dates and summaries. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
count | number | 3 | — |
by | string | "both" | both categories tags |
fallback | boolean | true | — |
heading | string | "" | — |
headingLevel | number | 2 | — |
showImage | boolean | true | — |
showDate | boolean | true | — |
showExcerpt | boolean | false | — |
Search pbs/search-form
Pro. A search box for this website. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
label | string | "" | — |
placeholder | string | "" | — |
buttonText | string | "" | — |
showLabel | boolean | false | — |
iconButton | boolean | true | — |
postType | string | "" | — |
Share buttons pbs/share-buttons
Pro. Buttons that share this page on social networks, by email, or by copying its link. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
networks | array | ["facebook","x","linkedin","whatsapp"… | — |
showLabels | boolean | false | — |
shape | string | "rounded" | — |
native | boolean | true | — |
label | string | "" | — |
Editor supports: interactivity.
Shop page pbs/shop-page
Pro. The WooCommerce part of a shop page in a template: the page’s own cart or checkout (block or classic), the classic cart, checkout or My Account, or the order-received details. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
page | string | "content" | content cart checkout account order |
Site header pbs/site-header
Pro. The top of the website: logo, navigation and anything else, in one or more rows; optionally sticky, transparent, shrinking or hiding while scrolling down. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
sticky | boolean | false | — |
transparent | boolean | false | — |
shrink | boolean | false | — |
hideOnScroll | boolean | false | — |
stickyFrom | number | 0 | — |
Editor supports: interactivity.
Sitemap pbs/sitemap
Free. A page listing every published page and post (and other public content), with the page tree kept. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
postTypes | array | ["page","post"] | — |
showHeadings | boolean | true | — |
headingLevel | number | 2 | — |
Store locator pbs/store-locator
Pro. Every location in a list visitors can search or sort by distance, and on an OpenStreetMap map that loads only when a visitor asks for it. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
label | string | "" | — |
locations | array | [] | — |
showSearch | boolean | true | — |
showMap | boolean | true | — |
zoom | integer | 0 | — |
Editor supports: interactivity.
Table of contents pbs/table-of-contents
Free. A list of the headings on the page, built automatically, that links to each one. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
title | string | "" | — |
minLevel | integer | 2 | — |
maxLevel | integer | 3 | — |
ordered | boolean | false | — |
collapsible | boolean | false | — |
collapsed | boolean | false | — |
spy | boolean | true | — |
Casino, iGaming and affiliate
Affiliate button pbs/affiliate-button
Pro. A button to an offer, marked as a sponsored link, optionally through a short link that counts clicks. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
text | string | "" | — |
url | string | "" | — |
linkId | number | 0 | — |
newTab | boolean | true | — |
variant | string | "fill" | fill outline |
size | string | "medium" | small medium large |
Age gate pbs/age-gate
Pro. Asks visitors to confirm their age before they see the website, with a minimum age per country. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
minAge | number | 18 | — |
rules | array | [] | — |
mode | string | "confirm" | confirm birthdate |
rememberDays | number | 30 | — |
title | string | "" | — |
message | string | "" | — |
deniedMessage | string | "" | — |
Editor supports: interactivity.
Casino comparison table pbs/casino-table
Pro. Offers compared side by side, each with its bonus, rating, highlights, button and terms. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
offers | array | [] | — |
caption | string | "" | — |
showRank | boolean | true | — |
showRating | boolean | true | — |
showFeatures | boolean | true | — |
notice | string | "" | — |
age | number | 18 | — |
Crypto prices pbs/crypto-ticker
Pro. Cryptocurrency prices from CoinGecko, as a ticker, cards or a price chart. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
coins | array | ["bitcoin","ethereum","solana"] | — |
currency | string | "usd" | — |
layout | string | "ticker" | ticker cards chart |
days | number | 7 | — |
label | string | "" | — |
Offer card pbs/offer-card
Pro. One offer: logo, bonus, highlights, a sponsored button, its terms and an age notice. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
name | string | "" | — |
logo | string | "" | — |
logoId | number | 0 | — |
bonus | string | "" | — |
description | string | "" | — |
features | string | "" | — |
rating | number | 0 | — |
url | string | "" | — |
linkId | number | 0 | — |
cta | string | "" | — |
terms | string | "" | — |
badge | string | "" | — |
age | number | 18 | — |
headingLevel | string | "h2" | h2 h3 h4 p |
Pros and cons pbs/pros-cons
Pro. Two lists side by side: what is good and what is not. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
prosTitle | string | "" | — |
consTitle | string | "" | — |
pros | array | [] | — |
cons | array | [] | — |
headingLevel | string | "h2" | h2 h3 h4 p |
Responsible gambling notice pbs/rg-notice
Pro. A responsible gambling message and help link, chosen for the visitor’s country. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
text | string | "" | — |
url | string | "" | — |
linkText | string | "" | — |
useHelp | boolean | true | — |
countries | array | [] | — |
showAge | boolean | true | — |
age | number | 18 | — |
Review score pbs/review-score
Pro. An overall score, scores for each criterion, and a verdict. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
score | number | 8 | — |
scale | number | 10 | — |
label | string | "" | — |
criteria | array | [] | — |
verdict | string | "" | — |
Widgets and add-ons
Shortcode (add-on) pbs/shortcode
Free. A shortcode from an add-on written for the classic Page Builder Sandwich editor, with the settings the add-on declared. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
tag | string | "" | — |
attrs | object | {} | — |
content | string | "" | — |
Widget pbs/widget
Free. Shows one of the site’s registered classic widgets. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
widget | string | "" | — |
instance | object | {} | — |
fallbackHtml | string | "" | — |
Widget area pbs/sidebar
Free. Shows the widgets in one of the theme’s widget areas. See it working.
| Attribute | Type | Default | Values |
|---|---|---|---|
sidebar | string | "" | — |
fallbackHtml | string | "" | — |