Skip to content
WPPoland Documentation

Getting started

Most shops can publish their first shoppable image in a few minutes. Install, create a lookbook, pin products, embed.

Before you start

Section titled “Before you start”
  • WordPress 6.5 or newer
  • WooCommerce active (HPOS and Cart/Checkout Blocks supported)
  • PHP 8.1 or newer

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install Lookbook from the plugin directory (when live on WordPress.org) or upload the lookbook folder to /wp-content/plugins/.
  3. Activate the plugin.

Create your first lookbook

Section titled “Create your first lookbook”
  1. Go to Lookbooks → Add New.
  2. Set the Featured image — this is the scene shoppers will shop.
  3. Add a hotspot for each product:
    • X and Y — percentages from the top-left of the image (0–100). The live preview shows exactly where each marker lands.
    • Product ID — the WooCommerce product to pin.
  4. Publish the lookbook.

Find a lookbook’s ID

Section titled “Find a lookbook’s ID”

Open the Lookbooks list and edit a lookbook; the ID appears in the URL (post=123). Use it in the shortcode or block.

Embed it

Section titled “Embed it”
[lookbook id="123"]

Or insert the Lookbook block in the block editor and choose your lookbook.

Global presentation

Section titled “Global presentation”

Open WooCommerce → Lookbook to set defaults:

  • Show price — toggle the live price in the product card.
  • Show add-to-cart — toggle the add-to-cart link, and customise its label.
  • Marker style — pulsing dot, plus sign, or numbered.

Verify on the storefront

Section titled “Verify on the storefront”
  1. Open the page where you embedded the lookbook.
  2. The image should load with hotspot markers, with no layout shift.
  3. Activate a marker (click or keyboard) — the product-card popover should open with thumbnail, title, live price and add-to-cart.
  4. Confirm deleted or unpublished products produce no marker.

Free vs PRO

Section titled “Free vs PRO”

The free edition covers the shoppable image, hotspot editor, accessible markers, the product-card popover, three marker styles, and the shortcode plus block.

Lookbook PRO (planned) adds multiple images per lookbook, animation styles, video hotspots and analytics — not the basic shoppable image.

Need help?

Section titled “Need help?”