Intro
Shop Settings control your product listing page appearance and sections. This is where you customize the shop homepage experience.
Access: Go to /admin → Shop → Shop Settings
Hero Section
The large banner at the top of your shop page:
- Hero Title: Main headline (e.g., "Welcome to Our Store")
- Hero Subtitle: Supporting text under the title
- Hero Body: Additional descriptive text
- Hero Image: Large banner image (1920x1080px recommended)
- Hero Button Text: Call-to-action button text (e.g., "Shop Now")
- Hero Button Link: Where the button links to (e.g.,
/shop/)
Intro Section (Optional)
Text block that appears below the hero:
- Show intro section: Toggle on/off
- Intro Title: Section heading
- Intro Body: Rich text content (uses TinyMCE editor)
Product Spotlight
Two-column section highlighting a specific product or promotion:
- Show spotlight: Toggle on/off
- Spotlight Title: Section heading
- Spotlight Body: Descriptive text
- Spotlight Image: Featured image
- Image Position: Left or Right
- Button Text: Call-to-action button
- Button Link: URL for the button
Section Ordering
Control the display order (lower numbers appear first). The hero always appears at top, products at bottom:
- Intro Order: Position of intro section
- Promo Blocks Order: Position of three-column promos
- Spotlight Order: Position of product spotlight
Promo Blocks
Three-column promotional cards:
- Show promo blocks: Toggle on/off
- Click "Add another Shop promo block" to add cards
- Each block has: title, body text, image, and optional button link
Display Options
Control how products appear:
- Products Per Page: How many products per page (default: 12)
- Show Products On Home Page (use it when Shop is your home page): Untick this box if you do not want products to show on the shop page
- Product Display Mode: Grid or List view
- Display Category: Filter to show only products from a specific category (leave blank for all)
Stripe Configuration
Override .env Stripe settings per-site:
- Live Mode: Toggle test/live mode
- Public Key: Your Stripe publishable key
- Secret Key: Your Stripe secret key (encrypted at rest)
- Webhook Secret: Stripe webhook signing secret
Email Configuration
- Email Host: SMTP server (e.g., smtp.gmail.com)
- Email Port: Usually 587 for TLS
- Use TLS: Checked for secure connection
- Email User: SMTP username
- Email Password: SMTP password
- From Address: Email address for outgoing emails