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
- A customer clicks the Share button on their wishlist and copies the link
- The link includes a share token (e.g.
?token=abc123) - The recipient opens the link and lands on a page in your theme
- The widget reads the token from the URL, fetches the shared wishlist data, and renders the product cards
- 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
- Go to Online Store → Pages in your Shopify admin
- Click Add page
- Enter a title — for example, “Shared Wishlist”
- The page content can be left blank (the widget will render everything)
- Click Save
Step 2: Add the Shared Wishlist block in the theme editor
- Go to Online Store → Themes → Customize
- In the page picker dropdown at the top, select Pages → Shared Wishlist (or whatever you titled the page)
- In the left sidebar under Template, click Add section or Add block
- Find and select Shared Wishlist Page (under the SimplerSuite Wishlist app)
- Customize the settings to match your theme (see Customization options below)
- 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.
- Open the SimplerSuite Wishlist dashboard in your Shopify admin
- Go to Branding & Emails → Theme tab
- Scroll to the Share Link Preview section
- In the In-store share page path field, enter the path to the page you created — for example,
/pages/shared-wishlist - 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
- Go to your store and add some items to a wishlist
- Open the wishlist page and click Share
- Paste the copied link in a new browser tab
- 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
| Setting | Default | Description |
|---|---|---|
| Show page title | On | Displays the wishlist name and item count as the page heading |
| Fallback title | ”Shared Wishlist” | Shown briefly while the wishlist data loads |
| Max width | 1200px | Maximum width of the page content (range: 600–1800px) |
Product grid
| Setting | Default | Description |
|---|---|---|
| Minimum card width | 220px | Controls how many columns appear at different screen sizes (range: 140–400px) |
| Gap between cards | 20px | Spacing between product cards (range: 4–48px) |
| Image aspect ratio | Square (1:1) | Options: Square (1:1), Landscape (4:3), Portrait (3:4), Wide (16:9) |
Card style
| Setting | Default | Description |
|---|---|---|
| Corner radius | 8px | Rounded corners on product cards (range: 0–24px) |
| Card border color | None | Set a border color, or leave blank for no border |
| Card shadow | None | Options: None, Subtle, Medium, Large |
| Card hover effect | None | Options: None, Lift, Glow |
| Content padding | 12px | Padding inside the card below the image (range: 8–32px) |
| Card background color | Inherited | Leave blank to inherit from your theme |
| Card text color | Inherited | Leave blank to inherit from your theme |
Card content
| Setting | Default | Description |
|---|---|---|
| Text alignment | Left | Left or Center |
| Show product vendor | Off | Displays the product vendor/brand |
| Show price | On | Displays the product price |
| Show sale price | On | Displays a strikethrough original price when a product is on sale |
| Sale badge color | #e53e3e | Background color of the “Sale” badge |
| Out of stock label color | #e53e3e | Color of the “Out of Stock” label |
| Out-of-stock items | Show with label | Options: Show with label, Show greyed out, Hide |
Buttons
| Setting | Default | Description |
|---|---|---|
| Show “Add to Cart” button | On | Displays an ATC button on each product card |
| ”Add to Cart” button text | ”Add to Cart” | Customize the button label |
| Button color | Inherited | Leave blank for theme default |
| Button text color | Inherited | Leave blank for theme default |
| Button border color | Inherited | Leave blank for theme default |
| Button corner radius | 4px | Rounded corners on buttons (range: 0–24px) |
| Vertical padding | 10px | Button vertical padding (range: 4–24px) |
| Horizontal padding | 20px | Button 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.
| Setting | Default | Description |
|---|---|---|
| Show call-to-action section | On | Toggle 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 link | All products collection | Where 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.
The share link still points to the external preview
- 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.