Smart Grid
Show image #
Where to find it
YOOtheme builder › Smart Grid › Show image
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
1
Show title #
Where to find it
YOOtheme builder › Smart Grid › Show title
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
1
Where to find it
YOOtheme builder › Smart Grid › Show meta line
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
1
Show body content #
Where to find it
YOOtheme builder › Smart Grid › Show body content
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
1
Show primary button #
Where to find it
YOOtheme builder › Smart Grid › Show primary button
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
1
Show corner thumbnail (small image) #
Where to find it
YOOtheme builder › Smart Grid › Show corner thumbnail (small image)
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
1
Layout preset #
Where to find it
YOOtheme builder › Smart Grid › Layout preset
Pick a preset or fine-tune columns, gaps, card backgrounds, and the flip effect. - One-click style - picks coordinated values for layout, columns, image, and text fields. Switch to Custom to override individually. Changing any preset-controlled field auto-switches to Custom.
- Type
select
- Default
-
Custom (no preset)
- Options
-
- Custom (no preset)
custom
- Default Grid
default_grid
- Horizontal - Image Left
horizontal_left
- Horizontal - Image Right
horizontal_right
- Magazine / Editorial
magazine
- Cards / Tiles
cards_tiles
- List / Compact
list_compact
- Hero Spotlight
hero_spotlight
- Podcast / Audio Feed
podcast
- Advertisement
advertisement
- News Feed
news_feed
- Gallery
gallery
- Numbered - Dark Panel
numbered_dark
Items per page #
Where to find it
YOOtheme builder › Smart Grid › Items per page
Paginate the grid - show N items per page. 0 = no pagination (show all). Pagination is independent per grid (each grid uses its own URL parameter). For ZOO items, make sure "Number of items" on the Data tab is HIGHER than this value - otherwise all items fit in one page and the nav correctly hides itself.
- Type
number
- Default
-
0
Where to find it
YOOtheme builder › Smart Grid › Scroll to grid on pagination click
Default: on. When off, clicking Prev / Next / a page number changes the page silently without scrolling. Useful when the grid is short or inside a sticky section where the auto-scroll is disorienting.
- Type
checkbox
- Default
-
1
Where to find it
YOOtheme builder › Smart Grid › Scroll to grid when adding a favourite
Default: on. When a user clicks the heart icon on a card, the grid re-sorts so favourited items move to the top. This toggle controls whether the viewport also scrolls so the user sees the animation. When off, the re-sort still happens but the page stays where the user was.
- Type
checkbox
- Default
-
1
Default card layout #
Where to find it
YOOtheme builder › Smart Grid › Default card layout
Layout applied to every card unless overridden on a manual item. Horizontal variants place the image beside the text. Image-right variant also aligns the text block to the right.
- Type
select
- Default
-
Grid (image on top)
- Options
-
- Grid (image on top)
grid
- Horizontal - image left, text right
hleft
- Horizontal - image right, text left (aligned right)
hright
Primary button text #
Where to find it
YOOtheme builder › Smart Grid › Primary button text
Custom text for the Read more button. Leave empty to keep the default.
- Type
text
- Default
-
Not set
Primary button style #
Where to find it
YOOtheme builder › Smart Grid › Primary button style
This setting has no help text in the plugin.
- Type
select
- Default
-
Default
- Options
-
- Default
default
- Primary
primary
- Secondary
secondary
- Text-link
text
- Link (inline)
link
Where to find it
YOOtheme builder › Smart Grid › Button shape
This setting has no help text in the plugin.
- Type
select
- Default
-
Square with rounded corners (default)
- Options
-
- Square with rounded corners (default)
rounded
- Sharp corners (no rounding)
square
- Pill (fully round)
pill
Where to find it
YOOtheme builder › Smart Grid › Button hover animation
This setting has no help text in the plugin.
- Type
select
- Default
-
Lift (rise on hover)
- Options
-
- None
none
- Lift (rise on hover)
lift
- Glow (soft shadow grows)
glow
- Scale (subtle grow)
scale
- Slide (color sweep)
slide
- Bounce (one quick hop)
bounce
Hide arrow on Text-link buttons #
Where to find it
YOOtheme builder › Smart Grid › Hide arrow on Text-link buttons
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Show second link button #
Where to find it
YOOtheme builder › Smart Grid › Show second link button
Also configure the source side on the DATA tab - for ZOO items pick a "Second link element", for Joomla articles enter a custom-field name. Without that, the plugin has no URL to use for the second button.
- Type
checkbox
- Default
-
1
Second button text (default) #
Where to find it
YOOtheme builder › Smart Grid › Second button text (default)
Default label for the second button. Manual items can override per item.
- Type
text
- Default
-
More info
Second button style #
Where to find it
YOOtheme builder › Smart Grid › Second button style
This setting has no help text in the plugin.
- Type
select
- Default
-
Primary
- Options
-
- Default
default
- Primary
primary
- Secondary
secondary
- Text-link
text
- Link (inline)
link
Open second link in new tab #
Where to find it
YOOtheme builder › Smart Grid › Open second link in new tab
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Button row layout #
Where to find it
YOOtheme builder › Smart Grid › Button row layout
This setting has no help text in the plugin.
- Type
select
- Default
-
First left, second right
- Options
-
- First left, second right
split
- Both fill the full width
full
- Stacked (full width, top to bottom)
stacked
Image height (px) #
Where to find it
YOOtheme builder › Smart Grid › Image height (px)
Controls the image height on each card.
- Type
number
- Default
-
200
Image fit mode #
Where to find it
YOOtheme builder › Smart Grid › Image fit mode
How the image fills its container. Cover crops to fill, Contain shows the whole image, Fill stretches.
- Type
select
- Default
-
Cover (crop to fill)
- Options
-
- Cover (crop to fill)
cover
- Contain (show whole)
contain
- Fill (stretch)
fill
Image interaction #
Where to find it
YOOtheme builder › Smart Grid › Image interaction
How multiple images per card behave. Slideshow uses arrows and dots. Hover scrub / 360 lets visitors move the cursor left-right across the image (or drag on touch) to flip through the frames - ideal for 360-degree product shots.
- Type
select
- Default
-
Slideshow (arrows + dots)
- Options
-
- Slideshow (arrows + dots)
slideshow
- Hover scrub / 360 spin
hover_scrub
Auto-spin until hovered #
Where to find it
YOOtheme builder › Smart Grid › Auto-spin until hovered
When hover scrub is on, the frames gently rotate on their own until the visitor hovers or drags, then control is handed over.
- Type
checkbox
- Default
-
0
Make title clickable #
Where to find it
YOOtheme builder › Smart Grid › Make title clickable
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
1
Title colour #
Where to find it
YOOtheme builder › Smart Grid › Title colour
This setting has no help text in the plugin.
- Type
select
- Default
-
Default
- Options
-
- Default
default
- Primary
primary
- Secondary
secondary
Title tag (H1-H6) #
Where to find it
YOOtheme builder › Smart Grid › Title tag (H1-H6)
Semantic heading element used to wrap each card title. Defaults to <h3> since cards are typically subordinate to the page heading.
- Type
select
- Default
-
H3
- Options
-
- H1
h1
- H2
h2
- H3
h3
- H4
h4
- H5
h5
- H6
h6
Title visual style #
Where to find it
YOOtheme builder › Smart Grid › Title visual style
Visual heading style applied to the title (UIkit heading classes). "Default" inherits the active YOOtheme theme styling. The other options match YOOtheme Pro Headline element.
- Type
select
- Default
-
Not set
- Options
-
- Default
- Heading 2XLarge
uk-heading-2xlarge
- Heading XLarge
uk-heading-xlarge
- Heading Large
uk-heading-large
- Heading Medium
uk-heading-medium
- Heading Small
uk-heading-small
- Heading Hero
uk-heading-hero
- Heading Divider
uk-heading-divider
- Heading Bullet
uk-heading-bullet
- Heading Line
uk-heading-line
Columns #
Where to find it
YOOtheme builder › Smart Grid › Columns
This setting has no help text in the plugin.
- Type
select
- Default
-
3 Columns
- Options
-
- 1 Column
1
- 2 Columns
2
- 3 Columns
3
- 4 Columns
4
- 5 Columns
5
- 6 Columns
6
Gap between items #
Where to find it
YOOtheme builder › Smart Grid › Gap between items
This setting has no help text in the plugin.
- Type
select
- Default
-
Medium
- Options
-
- Small
small
- Medium
medium
- Large
large
Where to find it
YOOtheme builder › Smart Grid › Platform
Available now: YouTube, Bluesky, Mastodon, Reddit, Vimeo, Spotify, SoundCloud (free). TikTok (requires an Apify token -- free tier covers ~1,300 videos/month). Coming next: Instagram (Apify, v2.28.93), then X / Pinterest / Facebook / LinkedIn / Tumblr. Picking a "coming soon" entry leaves the grid empty until that release lands.
- Type
select
- Default
-
YouTube
- Options
-
- YouTube
youtube
- Bluesky
bluesky
- Mastodon
mastodon
- Reddit
reddit
- Vimeo
vimeo
- Spotify
spotify
- SoundCloud
soundcloud
- Instagram (coming soon)
instagram
- TikTok
tiktok
- X / Twitter (coming soon)
twitter
- Pinterest (coming soon)
pinterest
- Facebook Pages (coming soon)
facebook
- LinkedIn (coming soon)
linkedin
- Tumblr (coming soon)
tumblr
YouTube API Key #
Where to find it
YOOtheme builder › Smart Grid › YouTube API Key
Free Google Cloud API key. Get one at https://console.cloud.google.com/ -> Create project -> APIs & Services -> Library -> enable "YouTube Data API v3" -> Credentials -> Create credentials -> API key. The key sits in plain text in this element's saved props (same as any YOOtheme element field), so use Google's "Restrict key" feature to lock it to YouTube Data API v3 only.
- Type
text
- Default
-
Not set
Source type #
Where to find it
YOOtheme builder › Smart Grid › Source type
Channel = latest uploads from a channel. Playlist = items from a specific playlist. Search = videos matching a keyword query.
- Type
select
- Default
-
Channel
- Options
-
- Channel
channel
- Playlist
playlist
- Search keyword
search
Source value #
Where to find it
YOOtheme builder › Smart Grid › Source value
Channel: channel ID (UCxxxx), @handle, or full youtube.com/@handle URL. Playlist: playlist ID (PLxxxx) or full URL. Search: a keyword or phrase.
- Type
text
- Default
-
Not set
Items to fetch #
Where to find it
YOOtheme builder › Smart Grid › Items to fetch
How many videos to display per grid (1-50, default 12).
- Type
number
- Default
-
12
Refresh interval #
Where to find it
YOOtheme builder › Smart Grid › Refresh interval
How long the fetched feed is cached before re-querying the YouTube API. Longer = less quota use; shorter = fresher.
- Type
select
- Default
-
Every 60 minutes
- Options
-
- Every 60 minutes
3600
- Every 6 hours
21600
- Every 24 hours
86400
Order (search only) #
Where to find it
YOOtheme builder › Smart Grid › Order (search only)
Applies only when source type is Search. Ignored for Channel / Playlist sources (those return videos in their native order: most-recent upload first).
- Type
select
- Default
-
Most recent
- Options
-
- Most recent
date
- Most viewed
viewCount
- Top rated
rating
- Relevance
relevance
Include Shorts #
Where to find it
YOOtheme builder › Smart Grid › Include Shorts
YouTube's API does not cleanly separate Shorts from regular videos. When unchecked, the plugin filters items whose duration looks short; some Shorts may still slip through.
- Type
checkbox
- Default
-
1
Source type #
Where to find it
YOOtheme builder › Smart Grid › Source type
Profile = latest posts from a Bluesky account. Search = posts matching a keyword across the network.
- Type
select
- Default
-
Profile
- Options
-
- Profile
profile
- Search keyword
search
Source value #
Where to find it
YOOtheme builder › Smart Grid › Source value
Profile: full handle like alice.bsky.social, or @alice.bsky.social, or bsky.app/profile/alice.bsky.social URL. Search: a keyword or phrase.
- Type
text
- Default
-
Not set
Items to fetch #
Where to find it
YOOtheme builder › Smart Grid › Items to fetch
How many posts to display per grid (1-100, default 12).
- Type
number
- Default
-
12
Refresh interval #
Where to find it
YOOtheme builder › Smart Grid › Refresh interval
How long the fetched feed is cached before re-querying the Bluesky API. The public Bluesky API has no auth and generous rate limits; 60-minute refresh is fine for typical grids.
- Type
select
- Default
-
Every 60 minutes
- Options
-
- Every 60 minutes
3600
- Every 6 hours
21600
- Every 24 hours
86400
Include reposts #
Where to find it
YOOtheme builder › Smart Grid › Include reposts
When unchecked, only original posts from the account appear (reposts of other users are filtered out). Default: off.
- Type
checkbox
- Default
-
0
Source type #
Where to find it
YOOtheme builder › Smart Grid › Source type
Profile = latest posts from a Mastodon user. Hashtag = posts tagged with a topic on the chosen instance.
- Type
select
- Default
-
Profile
- Options
-
- Profile
profile
- Hashtag
hashtag
Mastodon instance #
Where to find it
YOOtheme builder › Smart Grid › Mastodon instance
Hostname of the Mastodon instance to query (without https://). For profile mode this is used only when the handle does not include an instance (alice instead of This email address is being protected from spambots. You need JavaScript enabled to view it.). For hashtag mode this picks which instance to read the timeline from. Default: mastodon.social.
- Type
text
- Default
-
mastodon.social
Source value #
Where to find it
YOOtheme builder › Smart Grid › Source value
Profile: handle like This email address is being protected from spambots. You need JavaScript enabled to view it. (full Fediverse address) or just alice (uses the instance field above). Hashtag: tag name with or without #.
- Type
text
- Default
-
Not set
Items to fetch #
Where to find it
YOOtheme builder › Smart Grid › Items to fetch
How many posts to display per grid (1-40 due to Mastodon API limit, default 12).
- Type
number
- Default
-
12
Refresh interval #
Where to find it
YOOtheme builder › Smart Grid › Refresh interval
How long the fetched feed is cached before re-querying.
- Type
select
- Default
-
Every 60 minutes
- Options
-
- Every 60 minutes
3600
- Every 6 hours
21600
- Every 24 hours
86400
Hide replies #
Where to find it
YOOtheme builder › Smart Grid › Hide replies
When checked, only the user's top-level posts appear (no replies to other users). Default: on.
- Type
checkbox
- Default
-
1
Source type #
Where to find it
YOOtheme builder › Smart Grid › Source type
Subreddit = posts from r/SUB. User = posts by u/USER. Search = posts matching a keyword across Reddit.
- Type
select
- Default
-
Subreddit
- Options
-
- Subreddit
subreddit
- User submissions
user
- Search keyword
search
Source value #
Where to find it
YOOtheme builder › Smart Grid › Source value
Subreddit: name like pics, art, photography (with or without r/). User: u/USER or full URL. Search: a keyword or phrase.
- Type
text
- Default
-
Not set
Sort by #
Where to find it
YOOtheme builder › Smart Grid › Sort by
Hot is what the front page shows. New is freshest first. Top is highest-scoring within a time window (see Top window below). Rising is gaining traction.
- Type
select
- Default
-
Hot
- Options
-
- Hot
hot
- New
new
- Top
top
- Rising
rising
Top window #
Where to find it
YOOtheme builder › Smart Grid › Top window
Time window for Top sort. Ignored for other sorts.
- Type
select
- Default
-
Past day
- Options
-
- Past hour
hour
- Past day
day
- Past week
week
- Past month
month
- Past year
year
- All time
all
Items to fetch #
Where to find it
YOOtheme builder › Smart Grid › Items to fetch
How many posts to display per grid (1-100, default 12).
- Type
number
- Default
-
12
Refresh interval #
Where to find it
YOOtheme builder › Smart Grid › Refresh interval
How long the fetched feed is cached. Reddit rate-limits anonymous requests; 60-minute refresh is safe.
- Type
select
- Default
-
Every 60 minutes
- Options
-
- Every 60 minutes
3600
- Every 6 hours
21600
- Every 24 hours
86400
Hide text-only posts #
Where to find it
YOOtheme builder › Smart Grid › Hide text-only posts
When checked, only link/image posts appear in the grid. Default: off.
- Type
checkbox
- Default
-
0
Connection mode #
Where to find it
YOOtheme builder › Smart Grid › Connection mode
RSS mode needs nothing -- just a username. API mode needs a free Personal Access Token from developer.vimeo.com (richer data, faster, supports channels and groups).
- Type
select
- Default
-
RSS feed (zero setup)
- Options
-
- RSS feed (zero setup)
rss
- API with token (richer)
api
Vimeo Personal Access Token #
Where to find it
YOOtheme builder › Smart Grid › Vimeo Personal Access Token
Get a free token at developer.vimeo.com -> My Apps -> create app -> Generate Personal Access Token (scope: Public). Paste it here.
- Type
text
- Default
-
Not set
Source type #
Where to find it
YOOtheme builder › Smart Grid › Source type
User = latest videos from a Vimeo account. Channel / Group = curated collection. RSS mode also supports all three.
- Type
select
- Default
-
User
- Options
-
- User
user
- Channel
channel
- Group
group
Source value #
Where to find it
YOOtheme builder › Smart Grid › Source value
Username, channel slug, or group slug. Just the name (no vimeo.com prefix). For users you can paste a full URL like vimeo.com/username.
- Type
text
- Default
-
Not set
Items to fetch #
Where to find it
YOOtheme builder › Smart Grid › Items to fetch
How many videos to display per grid (1-100, default 12).
- Type
number
- Default
-
12
Refresh interval #
Where to find it
YOOtheme builder › Smart Grid › Refresh interval
How long the fetched feed is cached.
- Type
select
- Default
-
Every 60 minutes
- Options
-
- Every 60 minutes
3600
- Every 6 hours
21600
- Every 24 hours
86400
Spotify Client ID #
Where to find it
YOOtheme builder › Smart Grid › Spotify Client ID
Get a free pair at developer.spotify.com/dashboard -> Create app -> Web API. Copy the Client ID into this field and the Client Secret into the next.
- Type
text
- Default
-
Not set
Spotify Client Secret #
Where to find it
YOOtheme builder › Smart Grid › Spotify Client Secret
The Client Secret from the same Spotify developer dashboard. Treat as a password -- anyone with the secret can use your Spotify API quota.
- Type
text
- Default
-
Not set
Source type #
Where to find it
YOOtheme builder › Smart Grid › Source type
Playlist = tracks from a Spotify playlist. Artist top tracks = the artist most popular tracks. Show = podcast episodes. Album = tracks from a single album.
- Type
select
- Default
-
Playlist tracks
- Options
-
- Playlist tracks
playlist
- Artist top tracks
artist
- Podcast episodes
show
- Album tracks
album
Spotify URL or ID #
Where to find it
YOOtheme builder › Smart Grid › Spotify URL or ID
Paste any Spotify URL (open.spotify.com/playlist/... or spotify:playlist:...) or just the ID. Must match the source type above.
- Type
text
- Default
-
Not set
Items to fetch #
Where to find it
YOOtheme builder › Smart Grid › Items to fetch
How many items to display per grid (1-50, default 12).
- Type
number
- Default
-
12
Refresh interval #
Where to find it
YOOtheme builder › Smart Grid › Refresh interval
How long the fetched feed is cached.
- Type
select
- Default
-
Every 60 minutes
- Options
-
- Every 60 minutes
3600
- Every 6 hours
21600
- Every 24 hours
86400
Inline player #
Where to find it
YOOtheme builder › Smart Grid › Inline player
When checked, clicking a card opens the Spotify embed iframe right in the card. When unchecked, the card links out to open.spotify.com. Default: on.
- Type
checkbox
- Default
-
1
Where to find it
YOOtheme builder › Smart Grid › SoundCloud RSS feed URL
SoundCloud no longer hands out API keys, so we use their public RSS feed. Find your RSS URL at get-rss.com/soundcloud (free tool) or by viewing your SoundCloud profile source for "feeds.soundcloud.com". URL pattern: https://feeds.soundcloud.com/users/soundcloud:users:USER_ID/sounds.rss
- Type
text
- Default
-
Not set
Items to fetch #
Where to find it
YOOtheme builder › Smart Grid › Items to fetch
How many tracks to display per grid (1-50, default 12).
- Type
number
- Default
-
12
Refresh interval #
Where to find it
YOOtheme builder › Smart Grid › Refresh interval
How long the fetched feed is cached.
- Type
select
- Default
-
Every 60 minutes
- Options
-
- Every 60 minutes
3600
- Every 6 hours
21600
- Every 24 hours
86400
Inline player #
Where to find it
YOOtheme builder › Smart Grid › Inline player
When checked, the card embeds the SoundCloud player. When unchecked, the card links out to the track on soundcloud.com. Default: on.
- Type
checkbox
- Default
-
1
Apify API Token #
Where to find it
YOOtheme builder › Smart Grid › Apify API Token
Free Apify token from apify.com -> Settings -> API & Integrations. The Free plan ships with about $5 monthly credit, enough for roughly 1,300 TikTok videos or 1,800 Instagram posts per month. One token works for every Apify-powered platform in this grid -- you only paste it once.
- Type
text
- Default
-
Not set
Connection mode #
Where to find it
YOOtheme builder › Smart Grid › Connection mode
Apify scrapes ANY public TikTok profile / hashtag / search (costs Apify credits, ~$0.0037 per video). Display API only works for YOUR OWN TikTok account (you must log in via TikTok OAuth) but is completely free. Display API setup takes ~10 minutes: create a TikTok dev app, copy keys, complete an OAuth flow.
- Type
select
- Default
-
Apify (any public source, paid)
- Options
-
- Apify (any public source, paid)
apify
- Display API (own videos, free)
display_api
TikTok Client Key #
Where to find it
YOOtheme builder › Smart Grid › TikTok Client Key
From developers.tiktok.com -> Manage apps -> create app -> add "Display API" product. Copy the Client Key.
- Type
text
- Default
-
Not set
TikTok Client Secret #
Where to find it
YOOtheme builder › Smart Grid › TikTok Client Secret
From the same TikTok dev app. Treat as a password.
- Type
text
- Default
-
Not set
Redirect URI #
Where to find it
YOOtheme builder › Smart Grid › Redirect URI
The Redirect URI you configured in your TikTok app -- must match exactly. Any URL on a site you control works (e.g. https://yoursite.com/tiktok-callback). TikTok will redirect there with ?code=... in the URL after authorising.
- Type
text
- Default
-
Not set
One-time authorisation code #
Where to find it
YOOtheme builder › Smart Grid › One-time authorisation code
After filling the fields above: build this URL with your values and visit it in a browser: https://www.tiktok.com/v2/auth/authorize/?client_key=YOUR_CLIENT_KEY&response_type=code&scope=user.info.basic,video.list&redirect_uri=YOUR_REDIRECT_URI&state=smartgrid -- log in, grant access, TikTok redirects to your Redirect URI with ?code=XXXXX in the URL. Copy the code value and paste here, then save the grid. The plugin exchanges the code for access + refresh tokens automatically and stores them in the database; the code field can then be cleared (the tokens are persistent and auto-refresh).
- Type
text
- Default
-
Not set
Source type #
Where to find it
YOOtheme builder › Smart Grid › Source type
Profile = latest videos from a TikTok user. Hashtag = videos tagged with a topic. Search = videos matching a keyword.
- Type
select
- Default
-
Profile
- Options
-
- Profile
profile
- Hashtag
hashtag
- Search keyword
search
Source value #
Where to find it
YOOtheme builder › Smart Grid › Source value
Profile: username (with or without @, e.g. tiktok or @tiktok or tiktok.com/@tiktok URL). Hashtag: tag name (with or without #). Search: free-text keyword or phrase.
- Type
text
- Default
-
Not set
Items to fetch #
Where to find it
YOOtheme builder › Smart Grid › Items to fetch
How many videos per refresh (1-50, default 12). Apify charges per result returned. At Free-tier pricing, 12 videos = roughly $0.04 per refresh.
- Type
number
- Default
-
12
Refresh interval #
Where to find it
YOOtheme builder › Smart Grid › Refresh interval
How long the fetched feed is cached before Apify is called again. Apify costs money per call -- pick a longer TTL if the feed does not need to be fresh. The default is daily.
- Type
select
- Default
-
Every 24 hours
- Options
-
- Every 60 minutes
3600
- Every 6 hours
21600
- Every 24 hours
86400
Status #
Where to find it
YOOtheme builder › Smart Grid › Status
This platform is part of the roadmap (see the Platform select description for the schedule). The grid will stay empty until the release that adds it lands. Pick "YouTube" in the Platform select above to use the available source today.
- Type
text
- Default
-
Not set
Where to add items #
Where to find it
YOOtheme builder › Smart Grid › Where to add items
Manual cards are managed on the CONTENT tab: open it and click ADD ITEM to create cards. Each card's image, title, text, buttons, media and flip face live on the item itself.
- Type
text
- Default
-
Not set
Category ID #
Where to find it
YOOtheme builder › Smart Grid › Category ID
Joomla category ID to pull articles from. Use 0 to show all categories.
- Type
number
- Default
-
0
Number of items #
Where to find it
YOOtheme builder › Smart Grid › Number of items
Maximum number of articles to display.
- Type
number
- Default
-
12
Order by #
Where to find it
YOOtheme builder › Smart Grid › Order by
This setting has no help text in the plugin.
- Type
select
- Default
-
Newest first
- Options
-
- Newest first
date_desc
- Oldest first
date_asc
- Title A-Z
title
- Recently modified
modified
- Default ordering
ordering
Where to find it
YOOtheme builder › Smart Grid › Meta text shows
What appears as the small meta text on each article card.
- Type
select
- Default
-
Category name
- Options
-
- Category name
category
- Publication date
date
- Nothing
none
ZOO App #
Where to find it
YOOtheme builder › Smart Grid › ZOO App
Pick a ZOO application. Saved value is still the numeric app ID under the hood.
- Type
text
- Default
-
1
Item Type #
Where to find it
YOOtheme builder › Smart Grid › Item Type
Pick a ZOO item type. Leave empty / "All types" for every type in the selected app.
- Type
text
- Default
-
Not set
Category #
Where to find it
YOOtheme builder › Smart Grid › Category
Pick a ZOO category from your app. Leave as "All categories" to show everything.
- Type
text
- Default
-
0
Start from category #
Where to find it
YOOtheme builder › Smart Grid › Start from category
Leave empty for the top-level categories. Pick one to show only what sits underneath it.
- Type
text
- Default
-
Not set
Sub-categories #
Where to find it
YOOtheme builder › Smart Grid › Sub-categories
Sub-category cards appear next to their parent when it is clicked. A category with no sub-categories links straight to its own page.
- Type
select
- Default
-
Expand when clicked
- Options
-
- Expand when clicked
expand
- List inside the card
inside
- Do not show
hide
Where to find it
YOOtheme builder › Smart Grid › Category opens page
The page a category card opens. Pick one of your pages and the category id travels with the link. Leave it on the ZOO page to keep the old behaviour.
- Type
text
- Default
-
Not set
Or a page address #
Where to find it
YOOtheme builder › Smart Grid › Or a page address
Overrides the page above. A path on this site, for example /products. Leave empty to use the page picked above.
- Type
text
- Default
-
Not set
Card colour #
Where to find it
YOOtheme builder › Smart Grid › Card colour
Every top-level category gets its own colour, spread evenly around the one you choose below. Sub-categories keep their parent's colour in a lighter or darker shade.
- Type
select
- Default
-
Off (use the card background)
- Options
-
- Off (use the card background)
none
- A different colour per category
solid
- A different gradient per category
gradient
Base colour #
Where to find it
YOOtheme builder › Smart Grid › Base colour
All the card colours are derived from this one, so the grid stays on your palette.
- Type
color
- Default
-
#3b6ea5
Sub-category shade #
Where to find it
YOOtheme builder › Smart Grid › Sub-category shade
A sub-category keeps its parent's colour and is shown a shade lighter or darker, so it reads as belonging to it.
- Type
select
- Default
-
Lighter than its parent
- Options
-
- Lighter than its parent
lighter
- Darker than its parent
darker
Category from the URL #
Where to find it
YOOtheme builder › Smart Grid › Category from the URL
When a category card links to this page it carries the category id. Switch this on and the grid shows that category instead of the one saved above, which stays as the fallback.
- Type
checkbox
- Default
-
0
Number of items #
Where to find it
YOOtheme builder › Smart Grid › Number of items
Maximum number of ZOO items fetched from the database. This is the TOTAL pool available to the grid; "Items per page" (Layout tab) splits this pool into pages. If you want pagination, set this higher than "Items per page" - for example, 20 items here + 2 per page = 10 pages of pagination.
- Type
number
- Default
-
12
Order by #
Where to find it
YOOtheme builder › Smart Grid › Order by
This setting has no help text in the plugin.
- Type
select
- Default
-
Newest first
- Options
-
- Newest first
date_desc
- Oldest first
date_asc
- Title A-Z
title
- Most viewed
hits
- Priority (high to low)
priority_desc
- Priority (low to high)
priority_asc
Title element #
Where to find it
YOOtheme builder › Smart Grid › Title element
Which element provides the card title. Choose "(none)" to use the built-in ZOO item name.
- Type
text
- Default
-
Not set
Image element #
Where to find it
YOOtheme builder › Smart Grid › Image element
Which element provides the main card image.
- Type
text
- Default
-
Not set
Use all images from the image element #
Where to find it
YOOtheme builder › Smart Grid › Use all images from the image element
For a repeatable ZOO image element (e.g. ZOOlanders Image Pro) holding several images: load them ALL, in order, as the card image set. 2+ images then become a slideshow - or, with Image interaction set to Hover scrub / 360, a rotatable 360 view. Off = only the first image is used (default). Folders mode is supported (the folder images load in name order).
- Type
checkbox
- Default
-
0
Thumbnail element #
Where to find it
YOOtheme builder › Smart Grid › Thumbnail element
Which element provides the small corner thumbnail. Choose "(none)" to reuse the image element.
- Type
text
- Default
-
Not set
Content element #
Where to find it
YOOtheme builder › Smart Grid › Content element
Which element provides the card body text.
- Type
text
- Default
-
Not set
Item URL element #
Where to find it
YOOtheme builder › Smart Grid › Item URL element
Which element provides the item URL, used for the clickable title and card link. Choose "(none)" to auto-generate the ZOO item URL. Buttons are collected from this type's Link elements automatically - name them under "Button labels" below.
- Type
text
- Default
-
Not set
Where to find it
YOOtheme builder › Smart Grid › Only these link elements
Off (default): every ZOO link element with a value becomes a button. On: only the link elements you pick below become buttons, in the order you list them - use this to keep utility links (changelog, update server, etc.) out of the cards. The card still links to the item page.
- Type
checkbox
- Default
-
0
Button label - link element 1 #
Where to find it
YOOtheme builder › Smart Grid › Button label - link element 1
Give each ZOO link element its own button text. Pick the element, type the label, and the next row appears (up to 6). An item that fills in its own link text in ZOO overrides this. Elements with no label anywhere fall back to the element name.
- Type
text
- Default
-
Not set
Button text 1 #
Where to find it
YOOtheme builder › Smart Grid › Button text 1
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Open in new window 1 #
Where to find it
YOOtheme builder › Smart Grid › Open in new window 1
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Button label - link element 2 #
Where to find it
YOOtheme builder › Smart Grid › Button label - link element 2
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Button text 2 #
Where to find it
YOOtheme builder › Smart Grid › Button text 2
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Open in new window 2 #
Where to find it
YOOtheme builder › Smart Grid › Open in new window 2
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Button label - link element 3 #
Where to find it
YOOtheme builder › Smart Grid › Button label - link element 3
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Button text 3 #
Where to find it
YOOtheme builder › Smart Grid › Button text 3
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Open in new window 3 #
Where to find it
YOOtheme builder › Smart Grid › Open in new window 3
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Button label - link element 4 #
Where to find it
YOOtheme builder › Smart Grid › Button label - link element 4
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Button text 4 #
Where to find it
YOOtheme builder › Smart Grid › Button text 4
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Open in new window 4 #
Where to find it
YOOtheme builder › Smart Grid › Open in new window 4
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Button label - link element 5 #
Where to find it
YOOtheme builder › Smart Grid › Button label - link element 5
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Button text 5 #
Where to find it
YOOtheme builder › Smart Grid › Button text 5
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Open in new window 5 #
Where to find it
YOOtheme builder › Smart Grid › Open in new window 5
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Button label - link element 6 #
Where to find it
YOOtheme builder › Smart Grid › Button label - link element 6
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Button text 6 #
Where to find it
YOOtheme builder › Smart Grid › Button text 6
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Open in new window 6 #
Where to find it
YOOtheme builder › Smart Grid › Open in new window 6
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Where to find it
YOOtheme builder › Smart Grid › Meta text element
Which element provides the small meta line shown above the title (category, date, etc.).
- Type
text
- Default
-
Not set
Where to find it
YOOtheme builder › Smart Grid › Tags / filter element
Which element provides tags for the filter bar. Works with: ZOO Tag element, ZOO multi-Select element (since v2.14.78), or a plain Text element holding comma/semicolon/pipe/newline-separated tag names (since v2.14.86 - useful when scraping data that already includes tag strings).
- Type
text
- Default
-
Not set
YouTube URL element #
Where to find it
YOOtheme builder › Smart Grid › YouTube URL element
Which ZOO element holds a YouTube URL (text or link field). Items with a URL show a video; items without fall back to the image.
- Type
text
- Default
-
Not set
Radio stream element #
Where to find it
YOOtheme builder › Smart Grid › Radio stream element
Which ZOO element holds the radio / audio stream URL (.mp3, .aac, .m3u8, etc.). Items with a URL show an audio player; items without fall back to the image or YouTube video.
- Type
text
- Default
-
Not set
Radio player style #
Where to find it
YOOtheme builder › Smart Grid › Radio player style
How the audio player is shown on radio-stream cards.
- Type
select
- Default
-
Image + play-button overlay
- Options
-
- Image + play-button overlay
overlay
- Native audio controls bar
native
Spotify URL element #
Where to find it
YOOtheme builder › Smart Grid › Spotify URL element
Which ZOO element holds the Spotify URL (track, episode, show, album, or playlist). Items with a value render the Spotify embed in place of the image.
- Type
text
- Default
-
Not set
Spotify player mode #
Where to find it
YOOtheme builder › Smart Grid › Spotify player mode
Overlay + modal (recommended): card shows the cover image with a play button; click opens the Spotify player in a centered modal at proper width. Compact / Rich: render the embed inline inside the card (only good for wide cards, narrow cards may clip).
- Type
select
- Default
-
Overlay + modal (recommended)
- Options
-
- Overlay + modal (recommended)
overlay_modal
- Compact inline (152px)
compact
- Rich inline (352px)
rich
Spotify theme #
Where to find it
YOOtheme builder › Smart Grid › Spotify theme
Auto = light. Dark uses Spotify's dark embed UI.
- Type
select
- Default
-
Auto (light)
- Options
-
- Auto (light)
auto
- Dark
dark
Joomla custom field: YouTube URL #
Where to find it
YOOtheme builder › Smart Grid › Joomla custom field: YouTube URL
Name of a Joomla com_fields custom field holding a YouTube URL per article. Leave empty to rely only on auto-detect (URL scanning in article text).
- Type
text
- Default
-
Not set
Joomla custom field: radio / podcast URL #
Where to find it
YOOtheme builder › Smart Grid › Joomla custom field: radio / podcast URL
Custom field holding a radio stream or podcast audio URL.
- Type
text
- Default
-
Not set
Joomla custom field: Spotify URL #
Where to find it
YOOtheme builder › Smart Grid › Joomla custom field: Spotify URL
Custom field holding a Spotify URL.
- Type
text
- Default
-
Not set
Where to find it
YOOtheme builder › Smart Grid › Auto-detect media URLs from article text
For each media type, if the custom field above is empty (or empty for an article), the plugin will scan the article body for the first matching URL. Useful when authors embed media inline.
- Type
checkbox
- Default
-
1
Use all images found in the article #
Where to find it
YOOtheme builder › Smart Grid › Use all images found in the article
Scan each article (intro text + body) for images and load them ALL, in the order they appear, as the card image set. The featured (intro) image leads if set. 2+ images become a slideshow - or, with Image interaction set to Hover scrub / 360, a rotatable 360 view. Off = only the intro / full-article image is used (default).
- Type
checkbox
- Default
-
0
Second link element #
Where to find it
YOOtheme builder › Smart Grid › Second link element
Pick the ZOO Link / Text element that holds the SECOND URL for each item. Items where this is empty just show the primary link button.
- Type
text
- Default
-
Not set
Joomla custom field: second link URL #
Where to find it
YOOtheme builder › Smart Grid › Joomla custom field: second link URL
Name of a Joomla com_fields custom field per article that contains the second URL.
- Type
text
- Default
-
Not set
Show favourite heart #
Where to find it
YOOtheme builder › Smart Grid › Show favourite heart
Tag filter, favourites, search bar, loader animation, and intro text settings. - Uncheck to hide the heart / favourite button on all items in this grid.
- Type
checkbox
- Default
-
1
Where to find it
YOOtheme builder › Smart Grid › Show All / Favourites filter buttons
Uncheck to hide the filter bar containing the All / Favourites toggle buttons.
- Type
checkbox
- Default
-
1
Where to find it
YOOtheme builder › Smart Grid › Show tag filter bar
Uncheck to hide the row of tag pills (All, Podcast, Radio, etc.). The plugin still computes which items match each tag for URL-based filtering, but no visible bar is rendered. Useful when the grid is filtered by other means (search, manual URL).
- Type
checkbox
- Default
-
1
Lottie animation URL (optional) #
Where to find it
YOOtheme builder › Smart Grid › Lottie animation URL (optional)
Optional URL to a Lottie animation file (highest priority - overrides image and default spinner). Accepts BOTH formats: .lottie (compressed, ~1KB, e.g. https://lottie.host/abc-xyz.lottie) and .json (raw, ~5-10KB). Plugin lazy-loads the @lottiefiles/dotlottie-wc web component from unpkg CDN when needed. Get free animations from lottiefiles.com.
- Type
text
- Default
-
Not set
Lottie animation URL #2 (optional, random pool) #
Where to find it
YOOtheme builder › Smart Grid › Lottie animation URL #2 (optional, random pool)
Optional second Lottie URL. When set together with slot #1 (and/or #3), a random one is picked on EACH AJAX swap so consecutive clicks can show different loaders. Leave empty to keep slot #1 fixed.
- Type
text
- Default
-
Not set
Lottie animation URL #3 (optional, random pool) #
Where to find it
YOOtheme builder › Smart Grid › Lottie animation URL #3 (optional, random pool)
Optional third Lottie URL. Same as slot #2 - joins the random pool.
- Type
text
- Default
-
Not set
Loader image (optional) #
Where to find it
YOOtheme builder › Smart Grid › Loader image (optional)
Optional GIF / PNG / SVG to use as the loading indicator. Pick from media library or upload. Hidden when a Lottie URL is set. If both empty, default cyan ring spinner is used.
- Type
image
- Default
-
Not set
Default loader color #
Where to find it
YOOtheme builder › Smart Grid › Default loader color
Color of the default ring spinner (only used when no Lottie / no image is set).
- Type
color
- Default
-
#0891b2
Loader size (pixels) #
Where to find it
YOOtheme builder › Smart Grid › Loader size (pixels)
Width and height of the loader. Default 56px. Range 16-1000. The overlay grid wrapper expands to fit large loaders during AJAX swap.
- Type
number
- Default
-
56
Loader backdrop tint (optional) #
Where to find it
YOOtheme builder › Smart Grid › Loader backdrop tint (optional)
Optional tint color shown behind the loader during AJAX swap. Leave empty for a fully transparent backdrop with subtle blur (frosted glass - works on any page background). Pick white if you want the legacy white-tint look (good for white sites).
- Type
color
- Default
-
Not set
Loader backdrop edge fade (px) #
Where to find it
YOOtheme builder › Smart Grid › Loader backdrop edge fade (px)
Soft fade-to-transparent zone on each of the four edges of the loader backdrop. Default 32px makes heart buttons / badges that bleed past the grid edge dissolve naturally instead of being hard-sliced. Set 0 to disable (legacy hard edge). Range 0-200.
- Type
number
- Default
-
32
Show search bar #
Where to find it
YOOtheme builder › Smart Grid › Show search bar
Adds a debounced search input that filters items as the user types. Searches all text fields including title, content, intro, meta, tags, and extra fields. Combines with any active tag filter (AND).
- Type
checkbox
- Default
-
0
Search placeholder text #
Where to find it
YOOtheme builder › Smart Grid › Search placeholder text
Placeholder text shown in the search input when empty.
- Type
text
- Default
-
Search…
Show intro text #
Where to find it
YOOtheme builder › Smart Grid › Show intro text
Shows a short teaser above the description. Works for both ZOO items and Joomla articles.
- Type
checkbox
- Default
-
0
Intro text element (ZOO only) #
Where to find it
YOOtheme builder › Smart Grid › Intro text element (ZOO only)
Which ZOO element holds the intro text (text or textarea). If empty, falls back to the Content element configured above. Joomla articles always use introtext.
- Type
text
- Default
-
Not set
Spotlight start date element #
Where to find it
YOOtheme builder › Smart Grid › Spotlight start date element
ZOO Date element on each item holding the spotlight START datetime. v2.17.1+: when "Spotlight item IDs" is empty, any item with a non-empty date here auto-qualifies as a spotlight item from that date onwards. Leave empty = no start gating (items appear immediately).
- Type
text
- Default
-
Not set
Spotlight end date element #
Where to find it
YOOtheme builder › Smart Grid › Spotlight end date element
ZOO Date element on each item holding the spotlight END datetime. After this date the item drops out of the spotlight section and shows as a regular grid card. Leave empty = no end gating (items stay in spotlight indefinitely).
- Type
text
- Default
-
Not set
Rating average element (ZOO writeback) #
Where to find it
YOOtheme builder › Smart Grid › Rating average element (ZOO writeback)
OPTIONAL. ZOO Number element on each item that the plugin writes the rating average back to. Lets ZOO admin show / sort / export the rating, and allows other ZOO templates to use it. Leave empty = no ZOO writeback (plugin only uses its internal #__yc_smart_grid_ratings table). When set, the grid READS the rating from this element first, falling back to the plugin table if empty.
- Type
text
- Default
-
Not set
Rating count element (ZOO writeback) #
Where to find it
YOOtheme builder › Smart Grid › Rating count element (ZOO writeback)
OPTIONAL. ZOO Number element on each item that the plugin writes the vote count back to. Configure alongside the average element above for full ZOO writeback. Leave empty = no writeback for the count.
- Type
text
- Default
-
Not set
Use article publish dates as spotlight schedule #
Where to find it
YOOtheme builder › Smart Grid › Use article publish dates as spotlight schedule
When enabled, an article in the spotlight list is only shown as spotlight while it is between its own publish_up and publish_down dates. Outside that window it appears as a regular grid card. Note: articles outside their publish window are excluded from Joomla's query entirely, so this toggle only affects the spotlight section, not whether the article appears at all.
- Type
checkbox
- Default
-
0
Intro truncation mode #
Where to find it
YOOtheme builder › Smart Grid › Intro truncation mode
Lines = cut the intro after N visible lines using CSS line-clamp (ellipsis auto-added by the browser). Words = cut after N words and append a "..." manually.
- Type
select
- Default
-
Lines
- Options
-
Intro truncation count #
Where to find it
YOOtheme builder › Smart Grid › Intro truncation count
Number of lines (default 3) or words to show before truncating.
- Type
number
- Default
-
3
Where to find it
YOOtheme builder › Smart Grid › Show extra ZOO fields
Automatically shows the remaining ZOO elements (those not already mapped above) as a description list at the bottom of each card. Empty values are skipped.
- Type
checkbox
- Default
-
0
Where to find it
YOOtheme builder › Smart Grid › Extra fields heading (optional)
Optional small heading shown above the extra fields list on each card. Leave empty for no heading.
- Type
text
- Default
-
Not set
Where to find it
YOOtheme builder › Smart Grid › Extra fields text
Free text shown under the extra fields heading, above the fields themselves. Leave empty for none.
- Type
textarea
- Default
-
Not set
Where to find it
YOOtheme builder › Smart Grid › Pick which extra fields to show
Tick the ZOO elements you want shown on each card. Leave all unticked to show every unmapped element (default).
- Type
text
- Default
-
Not set
Where to find it
YOOtheme builder › Smart Grid › Show labels above extra fields
Default: on. Turn off for image/media-heavy extras where the label is just visual clutter.
- Type
checkbox
- Default
-
1
Where to find it
YOOtheme builder › Smart Grid › Media player layout
How to arrange multiple players (YouTube, Spotify, audio) under the card. Image extras are promoted to the primary image slot when it is empty.
- Type
select
- Default
-
Vertical stack (each player full width)
- Options
-
- Vertical stack (each player full width)
stack
- Tabbed switcher (one at a time)
tabs
Where to find it
YOOtheme builder › Smart Grid › Extra fields position
Where to render the extra fields list and media stack on each card. Above keeps the read-more as the final CTA; below keeps everything chronological.
- Type
select
- Default
-
Below the Read more button
- Options
-
- Below the Read more button
below_link
- Above the Read more button
above_link
Where to find it
YOOtheme builder › Smart Grid › Hide extras element
Optional. Pick a ZOO element (a yes/no, text or number works); any item where it has a value hides that item's extra fields. Leave empty and every item shows them.
- Type
text
- Default
-
Not set
Where to find it
YOOtheme builder › Smart Grid › RSS feed element
Which ZOO element holds each item's RSS feed URL (e.g. SG_RSS). The plugin fetches that feed, picks 2 random items, and renders them as a Related Links list above the Read more button. Feed is cached for 60 minutes per URL.
- Type
text
- Default
-
Not set
Where to find it
YOOtheme builder › Smart Grid › Show related links
Default: off. The feed is fetched once and cached for 60 minutes per URL so site load stays fast.
- Type
checkbox
- Default
-
0
Where to find it
YOOtheme builder › Smart Grid › Related links title
Heading shown above the list of related links. Leave empty to hide the heading.
- Type
text
- Default
-
Related links
Where to find it
YOOtheme builder › Smart Grid › Number of links to show
Picked at random from the RSS feed. Default: 2.
- Type
select
- Default
-
2
- Options
-
Unique Grid ID #
Where to find it
YOOtheme builder › Smart Grid › Unique Grid ID
Set a unique slug per grid (e.g. "home-grid"). Required so logged-in users' favourites are saved to their account and not confused with other grids on your site.
- Type
text
- Default
-
Not set
"All" filter button label #
Where to find it
YOOtheme builder › Smart Grid › "All" filter button label
This setting has no help text in the plugin.
- Type
text
- Default
-
All
"Favourites" filter button label #
Where to find it
YOOtheme builder › Smart Grid › "Favourites" filter button label
This setting has no help text in the plugin.
- Type
text
- Default
-
Favourites
Filter bar position #
Where to find it
YOOtheme builder › Smart Grid › Filter bar position
Where to display the tag filter and All/Favourites buttons relative to the grid.
- Type
select
- Default
-
Top (above the grid)
- Options
-
- Top (above the grid)
top
- Left sidebar
left
- Right sidebar
right
Plain button style #
Where to find it
YOOtheme builder › Smart Grid › Plain button style
Removes the pill/box styling from all tag and All/Favourites buttons, showing plain text labels instead.
- Type
checkbox
- Default
-
0
Emphasise filter labels #
Where to find it
YOOtheme builder › Smart Grid › Emphasise filter labels
Increases the font size and weight of all tag and All/Favourites labels.
- Type
checkbox
- Default
-
0
Flip all items #
Where to find it
YOOtheme builder › Smart Grid › Flip all items
Each item flips to reveal a back face. Set back content per item in the Flip tab.
- Type
checkbox
- Default
-
0
Flip trigger #
Where to find it
YOOtheme builder › Smart Grid › Flip trigger
"All at once" adds a button that flips the whole grid simultaneously.
- Type
select
- Default
-
Hover (each card)
- Options
-
- Hover (each card)
hover
- Click (each card)
click
- All at once (button)
all
Button label #
Where to find it
YOOtheme builder › Smart Grid › Button label
This setting has no help text in the plugin.
- Type
text
- Default
-
Flip all cards
Default back colour #
Where to find it
YOOtheme builder › Smart Grid › Default back colour
Used for any item that does not have its own back colour set.
- Type
color
- Default
-
#1a1a1a
Equal item height #
Where to find it
YOOtheme builder › Smart Grid › Equal item height
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Card background #
Where to find it
YOOtheme builder › Smart Grid › Card background
Default keeps the white card background. Transparent removes it entirely. Glass adds a subtle frosted overlay.
- Type
select
- Default
-
Default (white)
- Options
-
- Default (white)
default
- Transparent
transparent
- Glass (frosted overlay)
glass
Glass opacity (%) #
Where to find it
YOOtheme builder › Smart Grid › Glass opacity (%)
How opaque the glass overlay is. 5-15 % looks good on most dark sections.
- Type
number
- Default
-
8
Adaptive text colour #
Where to find it
YOOtheme builder › Smart Grid › Adaptive text colour
Titles, meta, body text, heart button, and read-more link all adapt to the parent background automatically.
- Type
checkbox
- Default
-
0
Adaptive card border #
Where to find it
YOOtheme builder › Smart Grid › Adaptive card border
Adds a faint currentColor border so cards remain visually separated on transparent or glass backgrounds.
- Type
checkbox
- Default
-
0
Favourites-Only Mode #
Where to find it
YOOtheme builder › Smart Grid › Favourites-Only Mode
When enabled, the grid shows only the items this user has favourited. The tag filter bar automatically adapts to show only tags present in their favourites.
- Type
checkbox
- Default
-
0
Show Star Rating #
Where to find it
YOOtheme builder › Smart Grid › Show Star Rating
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Filled star colour #
Where to find it
YOOtheme builder › Smart Grid › Filled star colour
This setting has no help text in the plugin.
- Type
color
- Default
-
#FFD700
Empty star colour #
Where to find it
YOOtheme builder › Smart Grid › Empty star colour
This setting has no help text in the plugin.
- Type
color
- Default
-
#e0e0e0
Rating position #
Where to find it
YOOtheme builder › Smart Grid › Rating position
This setting has no help text in the plugin.
- Type
select
- Default
-
Below text
- Options
-
- Below text
content
- Image overlay (bottom centre)
image
Rating alignment #
Where to find it
YOOtheme builder › Smart Grid › Rating alignment
This setting has no help text in the plugin.
- Type
select
- Default
-
Left (default)
- Options
-
- Left (default)
left
- Centred
center
- Right
right
Items between ads #
Where to find it
YOOtheme builder › Smart Grid › Items between ads
Number of normal grid items between each automatically injected ad. E.g. 4 = one ad after every 4 items.
- Type
number
- Default
-
4
Random placement #
Where to find it
YOOtheme builder › Smart Grid › Random placement
When enabled, each window of N items gets an ad at a random position within that window. Ads never appear in the first 2 rows and never adjacent to each other.
- Type
checkbox
- Default
-
0
Google AdSense #
Where to find it
YOOtheme builder › Smart Grid › Google AdSense
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Publisher ID #
Where to find it
YOOtheme builder › Smart Grid › Publisher ID
Your Google AdSense publisher ID. Format: ca-pub-XXXXXXXXXXXXXXXX
- Type
text
- Default
-
Not set
Ad slot ID #
Where to find it
YOOtheme builder › Smart Grid › Ad slot ID
The ad unit slot ID from your AdSense account (numbers only).
- Type
text
- Default
-
Not set
Where to find it
YOOtheme builder › Smart Grid › Ad format
This setting has no help text in the plugin.
- Type
select
- Default
-
Auto (responsive)
- Options
-
- Auto (responsive)
auto
- In-feed (native)
fluid
- Rectangle
rectangle
- Horizontal banner
horizontal
- Vertical
vertical
Ad layout key #
Where to find it
YOOtheme builder › Smart Grid › Ad layout key
The data-ad-layout-key from your AdSense In-feed unit. Required when format is In-feed.
- Type
text
- Default
-
Not set
Enable Spotlight #
Where to find it
YOOtheme builder › Smart Grid › Enable Spotlight
Featured items get larger cards with optional badges, glow, and animated borders. - Spotlight items appear in a special highlighted row above the filter bars. Mark individual items with the "Spotlight" checkbox on each item.
- Type
checkbox
- Default
-
0
Spotlight position #
Where to find it
YOOtheme builder › Smart Grid › Spotlight position
"Above the grid" renders a separate highlighted row before the filters. "Inside the grid" places spotlight cards at the top of the regular grid, always above favourited items.
- Type
select
- Default
-
Above the grid (separate section)
- Options
-
- Above the grid (separate section)
above
- Inside the grid (pinned to top)
inside
Spotlight columns #
Where to find it
YOOtheme builder › Smart Grid › Spotlight columns
This setting has no help text in the plugin.
- Type
select
- Default
-
2 Columns
- Options
-
- 1 Column
1
- 2 Columns
2
- 3 Columns
3
Spotlight item IDs (optional, dynamic sources) #
Where to find it
YOOtheme builder › Smart Grid › Spotlight item IDs (optional, dynamic sources)
Optional. Comma-separated article or ZOO item IDs to feature in the spotlight. v2.17.1+: leave empty to auto-qualify items by their spotlight start/end dates instead - every item with a date set becomes a spotlight item during its window. If you fill in IDs here, the dates only schedule which IDs from the list show up.
- Type
text
- Default
-
Not set
Border style #
Where to find it
YOOtheme builder › Smart Grid › Border style
This setting has no help text in the plugin.
- Type
select
- Default
-
Solid
- Options
-
- Solid
solid
- Dashed
dashed
- Dotted
dotted
- Double
double
- None
none
Border width (px) #
Where to find it
YOOtheme builder › Smart Grid › Border width (px)
This setting has no help text in the plugin.
- Type
number
- Default
-
2
Border colour #
Where to find it
YOOtheme builder › Smart Grid › Border colour
This setting has no help text in the plugin.
- Type
color
- Default
-
#FFD700
Show spotlight badge #
Where to find it
YOOtheme builder › Smart Grid › Show spotlight badge
Adds a customizable badge overlay (text + background colour) to spotlight items so visitors immediately see they are featured.
- Type
checkbox
- Default
-
1
Badge text #
Where to find it
YOOtheme builder › Smart Grid › Badge text
Text shown inside the badge. Keep it short (1-2 words) to fit nicely on the image.
- Type
text
- Default
-
Spotlight
Badge background colour #
Where to find it
YOOtheme builder › Smart Grid › Badge background colour
Background colour of the badge.
- Type
color
- Default
-
#dc2626
Badge text colour #
Where to find it
YOOtheme builder › Smart Grid › Badge text colour
Text colour inside the badge.
- Type
color
- Default
-
#ffffff
Animated border #
Where to find it
YOOtheme builder › Smart Grid › Animated border
The border colour rotates around the card like a spotlight beam.
- Type
checkbox
- Default
-
0
Animation speed #
Where to find it
YOOtheme builder › Smart Grid › Animation speed
This setting has no help text in the plugin.
- Type
select
- Default
-
Medium (3 s)
- Options
-
- Slow (5 s)
slow
- Medium (3 s)
medium
- Fast (1.5 s)
fast
Corner radius (px) #
Where to find it
YOOtheme builder › Smart Grid › Corner radius (px)
This setting has no help text in the plugin.
- Type
number
- Default
-
6
Default spotlight size #
Where to find it
YOOtheme builder › Smart Grid › Default spotlight size
How many grid cells a spotlight card spans. Individual cards can override it. On phones every card drops back to one cell.
- Type
select
- Default
-
Normal (1x1 cell)
- Options
-
- Full width (all columns)
full
- Big (2x2 cells)
2x2
- Wide (2x1 cells)
2x1
- Tall (1x2 cells)
1x2
- Normal (1x1 cell)
1x1
Spotlight image height (px) #
Where to find it
YOOtheme builder › Smart Grid › Spotlight image height (px)
Image height for spotlight cards only. 0 = use the Item display image height.
- Type
number
- Default
-
0
Auto-promote first N items #
Where to find it
YOOtheme builder › Smart Grid › Auto-promote first N items
0 = off. Promotes the first N items the grid loads to spotlight, on top of any you picked by hand. Adverts are never promoted.
- Type
number
- Default
-
0
Auto-promote items with tag #
Where to find it
YOOtheme builder › Smart Grid › Auto-promote items with tag
Comma-separated tags. Any item carrying one of them (case-insensitive) becomes a spotlight.
- Type
text
- Default
-
Not set
Where to find it
YOOtheme builder › Smart Grid › Extra fields on spotlight cards
Spotlight cards only. An item hidden by the Hide extras element stays hidden either way.
- Type
select
- Default
-
Inherit (same as the rest of the grid)
- Options
-
- Inherit (same as the rest of the grid)
inherit
- Always show on spotlights
always
- Never show on spotlights
never
Badge style #
Where to find it
YOOtheme builder › Smart Grid › Badge style
Shape of the spotlight badge. This is the spotlight badge only - the per-card Ribbon labels on the Content tab are a separate feature.
- Type
select
- Default
-
Pill (bottom-left)
- Options
-
- Pill (bottom-left)
pill
- Corner ribbon (bottom-right)
ribbon
- Corner label (bottom-left)
corner
- Banner across the image
banner
- None
none
Wide layout (image left + overlay right) #
Where to find it
YOOtheme builder › Smart Grid › Wide layout (image left + overlay right)
Hero-style spotlight card. Works at any spotlight_cols value.
- Type
checkbox
- Default
-
0
Wide layout background #
Where to find it
YOOtheme builder › Smart Grid › Wide layout background
Video uses the item's existing video URL (YouTube, Vimeo or a direct .mp4/.webm file) and plays it muted and looping behind the text. Any item without a video keeps its image. Phones and reduced-motion always show the image.
- Type
select
- Default
-
Image
- Options
-
- Image
image
- Video (falls back to image)
video
Overlay colour #
Where to find it
YOOtheme builder › Smart Grid › Overlay colour
This setting has no help text in the plugin.
- Type
select
- Default
-
Black
- Options
-
- Black
black
- White
white
- None
none
Overlay opacity (%) #
Where to find it
YOOtheme builder › Smart Grid › Overlay opacity (%)
How opaque the overlay is on the text side. Fades to transparent near the image.
- Type
number
- Default
-
70
Big title size (px) #
Where to find it
YOOtheme builder › Smart Grid › Big title size (px)
Title font size inside the wide spotlight card.
- Type
number
- Default
-
36
Radius glow #
Where to find it
YOOtheme builder › Smart Grid › Radius glow
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
1
Glow colour #
Where to find it
YOOtheme builder › Smart Grid › Glow colour
This setting has no help text in the plugin.
- Type
color
- Default
-
#FFD700
Glow size (px) #
Where to find it
YOOtheme builder › Smart Grid › Glow size (px)
Blur spread of the glow around the card.
- Type
number
- Default
-
18
Drop shadow #
Where to find it
YOOtheme builder › Smart Grid › Drop shadow
This setting has no help text in the plugin.
- Type
checkbox
- Default
-
0
Shadow colour #
Where to find it
YOOtheme builder › Smart Grid › Shadow colour
This setting has no help text in the plugin.
- Type
color
- Default
-
#000000
Shadow horizontal offset (px) #
Where to find it
YOOtheme builder › Smart Grid › Shadow horizontal offset (px)
This setting has no help text in the plugin.
- Type
number
- Default
-
0
Shadow vertical offset (px) #
Where to find it
YOOtheme builder › Smart Grid › Shadow vertical offset (px)
This setting has no help text in the plugin.
- Type
number
- Default
-
6
Shadow blur (px) #
Where to find it
YOOtheme builder › Smart Grid › Shadow blur (px)
This setting has no help text in the plugin.
- Type
number
- Default
-
20
Shadow spread (px) #
Where to find it
YOOtheme builder › Smart Grid › Shadow spread (px)
This setting has no help text in the plugin.
- Type
number
- Default
-
0
List name #
Where to find it
YOOtheme builder › Smart Grid › List name
Optional name for the list or series in the structured data. Leave empty to use the page or feed title.
- Type
text
- Default
-
Not set
Publisher name #
Where to find it
YOOtheme builder › Smart Grid › Publisher name
Optional. Use this only for your OWN content; leave empty for directories of other people's content.
- Type
text
- Default
-
Not set
Publisher logo URL #
Where to find it
YOOtheme builder › Smart Grid › Publisher logo URL
Optional absolute URL to the publisher logo (used together with Publisher name).
- Type
text
- Default
-
Not set
sameAs links #
Where to find it
YOOtheme builder › Smart Grid › sameAs links
Optional. One URL per line (official site, social profiles) for radio or podcast entities.
- Type
textarea
- Default
-
Not set
Radio frequency #
Where to find it
YOOtheme builder › Smart Grid › Radio frequency
Optional broadcast frequency of a radio station, e.g. 100.7 FM.
- Type
text
- Default
-
Not set
css #
Where to find it
YOOtheme builder › Smart Grid › css
Enter your own custom CSS. Smart Grid exposes these selectors so you can target any part of the grid:<br><br><strong>Grid structure</strong><br><code>.yc-fav-grid</code> - Grid container (the whole element wrapper)<br><code>.yc-fav-item</code> - Each card in the grid<br><code>.yc-grid-content</code> - Card content area (title, meta, body, buttons)<br><br><strong>Card image</strong><br><code>.yc-thumb-wrap</code> - Card image wrapper<br><code>.yc-thumb-img</code> - Card image itself<br><br><strong>Card background style</strong><br><code>.yc-card-glass</code> - Glass background<br><code>.yc-card-transparent</code> - Transparent background<br><code>.yc-card-border</code> - Bordered card<br><code>.yc-card-adaptive</code> - Adaptive text / border colors<br><br><strong>Layout modifiers</strong><br><code>.yc-equal-height</code> - Equal item height mode<br><code>.yc-cols-1 / -2 / -3 / -4</code> - Column-count modifier<br><code>.yc-gap-small / -medium / -large</code> - Gap modifier<br><code>.yc-default-layout-hleft</code> - Horizontal layout, image left<br><code>.yc-default-layout-hright</code> - Horizontal layout, image right<br><br><strong>Flip effect</strong><br><code>.yc-flip-card</code> - Flip-enabled card<br><code>.yc-flip-front</code> - Front face<br><code>.yc-flip-back</code> - Back face<br><code>.yc-flipped</code> - Card currently flipped<br><code>.yc-flip-all-btn</code> - “Flip all” control above the grid<br><br><strong>Filters and tags</strong><br><code>.yc-filter-btn</code> - Filter bar button (All / Favourites)<br><code>.yc-filter-active</code> - Active filter button<br><code>.yc-tag-btn</code> - Tag filter button<br><code>.yc-tag-active</code> - Active tag button<br><br><strong>Search</strong><br><code>.yc-search-wrap</code> - Search bar wrapper<br><code>.yc-search-input</code> - Search input<br><br><strong>Spotlight</strong><br><code>.yc-spotlight-section</code> - Spotlight container<br><code>.yc-spotlight-item</code> - Each spotlight item<br><code>.yc-sl-badge</code> - Spotlight badge<br><code>.yc-sl-image</code> - Spotlight image<br><br><strong>Star rating</strong><br><code>.yc-star-rating</code> - Star rating widget<br><code>.yc-star-fg</code> - Filled star<br><code>.yc-star-bg</code> - Empty star<br><br><strong>Ads and empty state</strong><br><code>.yc-ad-item</code> - Ad placement card<br><code>.yc-ad-google</code> - Google AdSense slot<br><code>.yc-favs-empty</code> - Empty favourites state<br><br><strong>Card box</strong><br><code>.yc-item-inner</code> - The card box itself; border, radius, background and shadow are set here, not on .yc-fav-item<br><code>.yc-heart-btn</code> - Favourite heart button<br><br><strong>Ribbon labels</strong><br><code>.yc-sg-ribbon</code> - Ribbon label; add a position modifier such as <code>.yc-sg-ribbon--corner-bottom-left</code> or <code>.yc-sg-ribbon--middle</code><br><br><strong>Wide spotlight hero</strong><br><code>.yc-sl-wide</code> - Full-width spotlight card<br><code>.yc-sl-overlay</code> - Gradient overlay above the hero image<br><code>.yc-sl-bgvideo</code> - Background video layer<br><br><em>Tip:</em> wrap rules with <code>.el-element</code> to scope to this grid only - e.g. <code>.el-element .yc-fav-item { ... }</code>
- Type
editor
- Default
-
Not set
Enable ribbon labels #
Where to find it
YOOtheme builder › Smart Grid › Enable ribbon labels
Show a small ribbon/label on each card (e.g. New, Sale, Popular). Off by default.
- Type
checkbox
- Default
-
0
Ribbon position #
Where to find it
YOOtheme builder › Smart Grid › Ribbon position
This setting has no help text in the plugin.
- Type
select
- Default
-
Corner top-left
- Options
-
- Corner top-left
corner-left
- Corner top-right
corner-right
- Corner bottom-left
corner-bottom-left
- Corner bottom-right
corner-bottom-right
- Side ribbon (left edge)
side
- Band across middle
middle
Tag -> label map #
Where to find it
YOOtheme builder › Smart Grid › Tag -> label map
One rule per line: tag=preset, tag=Custom text, or tag=Custom text|#hex. A card gets the label only if it carries that tag.
- Type
textarea
- Default
-
Not set
Social label preset #
Where to find it
YOOtheme builder › Smart Grid › Social label preset
This setting has no help text in the plugin.
- Type
select
- Default
-
None
- Options
-
- None
none
- Spotlight
spotlight
- New
new
- Popular
popular
- Improved
improved
- Sale
sale
- Custom
custom
Custom social label text #
Where to find it
YOOtheme builder › Smart Grid › Custom social label text
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Social label colour #
Where to find it
YOOtheme builder › Smart Grid › Social label colour
This setting has no help text in the plugin.
- Type
color
- Default
-
Not set
ZOO item #
Where to find it
YOOtheme builder › Smart Grid › ZOO item
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
ZOO item #
Where to find it
YOOtheme builder › Smart Grid › ZOO item
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
ZOO item #
Where to find it
YOOtheme builder › Smart Grid › ZOO item
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
ZOO item #
Where to find it
YOOtheme builder › Smart Grid › ZOO item
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
ZOO item #
Where to find it
YOOtheme builder › Smart Grid › ZOO item
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
ZOO item #
Where to find it
YOOtheme builder › Smart Grid › ZOO item
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Article #
Where to find it
YOOtheme builder › Smart Grid › Article
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Article #
Where to find it
YOOtheme builder › Smart Grid › Article
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Article #
Where to find it
YOOtheme builder › Smart Grid › Article
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Article #
Where to find it
YOOtheme builder › Smart Grid › Article
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Article #
Where to find it
YOOtheme builder › Smart Grid › Article
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Article #
Where to find it
YOOtheme builder › Smart Grid › Article
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set
Label (preset name or custom text) #
Where to find it
YOOtheme builder › Smart Grid › Label (preset name or custom text)
This setting has no help text in the plugin.
- Type
text
- Default
-
Not set