Skip to content

Shared Wishlist Page

When a customer shares their wishlist, the link can either point to an external preview page (hosted by SimplerSuite) or to a page on your own store. The in-store option provides a fully themed experience that matches your shop’s look and feel.

How it works

  1. A customer clicks the Share button on their wishlist and copies the link
  2. The link includes a share token (e.g. ?token=abc123)
  3. The recipient opens the link and lands on a page in your theme
  4. The widget reads the token from the URL, fetches the shared wishlist data, and renders the product cards
  5. The recipient can browse the items and add them to their cart

The shared wishlist page uses the same card rendering as the main wishlist page, so products look consistent across your store.

Setup

Step 1: Create a page in Shopify

  1. Go to Online Store → Pages in your Shopify admin
  2. Click Add page
  3. Enter a title — for example, “Shared Wishlist”
  4. The page content can be left blank (the widget will render everything)
  5. Click Save

Step 2: Add the Shared Wishlist block in the theme editor

  1. Go to Online Store → Themes → Customize
  2. In the page picker dropdown at the top, select Pages → Shared Wishlist (or whatever you titled the page)
  3. In the left sidebar under Template, click Add section or Add block
  4. Find and select Shared Wishlist Page (under the SimplerSuite Wishlist app)
  5. Customize the settings to match your theme (see Customization options below)
  6. Click Save

Step 3: Configure the share page path in the dashboard

This step tells the widget to use your in-store page instead of the external preview when customers copy the share link.

  1. Open the SimplerSuite Wishlist dashboard in your Shopify admin
  2. Go to Branding & Emails → Theme tab
  3. Scroll to the Share Link Preview section
  4. In the In-store share page path field, enter the path to the page you created — for example, /pages/shared-wishlist
  5. Click Save

Once saved, the share button will copy a URL like https://your-store.com/pages/shared-wishlist?token=abc123 instead of the external preview URL.

Step 4: Verify

  1. Go to your store and add some items to a wishlist
  2. Open the wishlist page and click Share
  3. Paste the copied link in a new browser tab
  4. You should see the shared wishlist rendered on your store, fully styled to match your theme

Customization options

All settings are available in the Shopify theme editor when you select the Shared Wishlist Page block. Changes are previewed in real time.

Page

SettingDefaultDescription
Show page titleOnDisplays the wishlist name and item count as the page heading
Fallback title”Shared Wishlist”Shown briefly while the wishlist data loads
Max width1200pxMaximum width of the page content (range: 600–1800px)

Product grid

SettingDefaultDescription
Minimum card width220pxControls how many columns appear at different screen sizes (range: 140–400px)
Gap between cards20pxSpacing between product cards (range: 4–48px)
Image aspect ratioSquare (1:1)Options: Square (1:1), Landscape (4:3), Portrait (3:4), Wide (16:9)

Card style

SettingDefaultDescription
Corner radius8pxRounded corners on product cards (range: 0–24px)
Card border colorNoneSet a border color, or leave blank for no border
Card shadowNoneOptions: None, Subtle, Medium, Large
Card hover effectNoneOptions: None, Lift, Glow
Content padding12pxPadding inside the card below the image (range: 8–32px)
Card background colorInheritedLeave blank to inherit from your theme
Card text colorInheritedLeave blank to inherit from your theme

Card content

SettingDefaultDescription
Text alignmentLeftLeft or Center
Show product vendorOffDisplays the product vendor/brand
Show priceOnDisplays the product price
Show sale priceOnDisplays a strikethrough original price when a product is on sale
Sale badge color#e53e3eBackground color of the “Sale” badge
Out of stock label color#e53e3eColor of the “Out of Stock” label
Out-of-stock itemsShow with labelOptions: Show with label, Show greyed out, Hide

Buttons

SettingDefaultDescription
Show “Add to Cart” buttonOnDisplays an ATC button on each product card
”Add to Cart” button text”Add to Cart”Customize the button label
Button colorInheritedLeave blank for theme default
Button text colorInheritedLeave blank for theme default
Button border colorInheritedLeave blank for theme default
Button corner radius4pxRounded corners on buttons (range: 0–24px)
Vertical padding10pxButton vertical padding (range: 4–24px)
Horizontal padding20pxButton horizontal padding (range: 8–48px)

Call to action

A CTA section appears below the product grid, encouraging visitors to browse your store and create their own wishlist.

SettingDefaultDescription
Show call-to-action sectionOnToggle the CTA section on or off
CTA title”Want your own wishlist?”Heading text
CTA message”Browse the store and save your favorite items for later.”Body text
CTA button text”Start Browsing”Button label
CTA button linkAll products collectionWhere the button links to

Custom CSS

You can add custom CSS rules in the Custom CSS textarea. Use .ssw- prefixed selectors to target shared wishlist elements:

/* Make the page title larger */
.ssw-shared-page .ssw-page-title {
font-size: 2.5rem;
}
/* Style the subtitle (shows item count) */
.ssw-shared-subtitle {
font-size: 1rem;
color: #666;
margin-top: 4px;
}
/* Style the CTA section */
.ssw-shared-cta {
background: #f9f9f9;
border-radius: 12px;
padding: 32px;
text-align: center;
}

Social previews (OG tags)

Even when using the in-store page, shared wishlist links still generate rich social previews. When someone pastes a share link on iMessage, WhatsApp, Slack, or social media, the preview card shows:

  • Your store’s logo and name
  • The wishlist name and item count
  • A grid of product images

These previews are generated server-side and use the logo and accent color configured in Branding & Emails → Theme.

Troubleshooting

The page shows “This wishlist has expired”

  • Share links expire after 30 days. The customer will need to share their wishlist again.
  • Make sure the URL contains a ?token= parameter. Without a token, the page can’t load any data.

The page is blank or shows only skeleton loaders

  • Make sure the SimplerSuite Wishlist app embed is enabled in Online Store → Themes → Customize → App embeds.
  • Check that the page has the Shared Wishlist Page block added in the theme editor.
  • Open the browser console and look for any errors.
  • Go to Branding & Emails → Theme and make sure the In-store share page path field is saved (e.g. /pages/shared-wishlist).
  • The path must start with / and match the actual page URL handle.
  • After saving, have the customer click Share again — the new link will use the in-store path.

Products don’t show “Add to Cart” buttons

  • Check that Show “Add to Cart” button is enabled in the block settings in the theme editor.
  • Products that are out of stock won’t show ATC buttons regardless of this setting.