Skip to main content
Add from: Widgets → Add widget → Gear shelf
A “what I use” grid. In card placement the widget renders as a single button (default label “Gear”); tapping it opens a modal of product cards. In scroll-page placement the grid is rendered inline.

​
Widget options

OptionWhat it does
LabelButton label in card placement (max 80 chars).
Grid columns (gearGridColumnsPerRow)1–12. Defaults to auto-fit.
Item sizesmall or large tiles.
Item chromesolid / transparent / glass / blur.
Item labelsToggle the name + category text under each tile.
Spread partial rowsAuto-fit the bottom row to span full width.

​
Per-item fields

Each items[] row has:
FieldWhat it does
NameProduct label (max 200 chars). Empty = falls back to the shop hostname or “Product”.
Category (optional)Like “Mouse”, “Keyboard”, “Mic”. Max 80 chars.
ImageUpload-only. Goes through the widget uploader (isGearShelfImagePath) — external image URLs are rejected by the schema. JPEG / PNG / WebP / GIF, max 2 MiB.
Product page URLRequired. Must be a valid http(s):// URL.
The dashboard has a “Set link to Amazon search” helper — when you’ve typed a name, it fills the URL with https://www.amazon.com/s?k=<name>. Handy for affiliate-free listings or when you don’t have a specific link.

​
Limits

  • 48 items per gear shelf widget (items.max(48)).
  • 16 widgets total per profile.
  • Each image upload max 2 MiB.

​
Tips

  • Square images look best in the grid — most product press shots are already square.
  • Group by category — visitors can scan “Mics” / “Keyboards” / “Cameras” instead of skimming 48 items.
  • Take your own product photos for a unique vibe, or download manufacturer press shots (be aware of usage rights).

​
Common questions

48 items per widget. If you need more, add a second gear shelf widget.
Yes — add a second widget. Useful for “Streaming gear” / “Photo gear” / “Daily carry”.
The product URL is required and must start with http:// or https://. Bare hostnames (example.com) won’t validate.