> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How to link your website's buttons to the storefront

> Point a button on your own website at a listing on your storefront, so it opens on your own subdomain in the same tab.

> [card] [Open in TWICE Admin](https://admin.twicecommerce.com/catalog/listings)
>
> catalog/listings

Point each button on your own website at a listing on your storefront. A customer who clicks it lands on that listing on your subdomain, in the same tab, and books or buys there. [Listing marketing and SEO settings](https://www.twicecommerce.com/docs/catalog/listings/marketing.md#url-slugs) explains how a listing's slugs make up its address.

Link a button to a collection the same way, from the **Marketing** tab of the collection under **Catalog → Collections**. Its address ends in `/collections/` and the slug, such as `/collections/used-bikes`. The TWICE Rentals app for Wix is a separate route that runs on TWICE 1.0.

## Prerequisites

> [!WARNING]
>
> **Required permissions:** **Create and edit listings** to change a listing's slug (`catalog:listing_seo:manage`). Every built-in role holds it, Member included. See [Users & Roles](https://www.twicecommerce.com/docs/settings/users-roles.md).

> [!NOTE]
>
> **Have ready before you start:**
>
> * **Your subdomain connected and set as primary** under **Settings → Domains**, such as `book.yourbrand.com`. Your website keeps its own domain. Owner and Admin can connect one. See [Set up the online store](https://www.twicecommerce.com/docs/guides/sales-channels/set-up-the-online-store.md).
> * **The listing on sale in the online store**, so its page opens. See [Where a listing sells](https://www.twicecommerce.com/docs/guides/sales-channels/control-where-a-listing-sells.md).
> * **Access to your website builder**, to change the button's link.

## The walkthrough

**1. Open the listing**

Open **Catalog** in the main menu and choose **Listings**. Find the listing the button should open and click its row. The listing opens on its **General** tab.

![The Listings table under Catalog, with Listings highlighted in the main menu and a listing's row highlighted](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-link-your-website-to-the-storefront-01.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=e9360d53584ce2e2cc8bf4a362a109b3)

**2. Open the Marketing tab**

Click **Marketing** in the row of tabs at the top of the listing. The **Search engine listing** card opens with **Slug** below the meta description. The field shows your storefront's address in front of the slug.

![The listing's Marketing tab, with the tab and the Search engine listing card highlighted, and Add slug under the meta description](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-link-your-website-to-the-storefront-02.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=9f951180a6f6db12b6af7890c9177461)

**3. Set the slug**

Check the slug in the field marked **Primary**. A listing gets one from its name when it is created, and an older listing may have none. Change it now if it reads poorly, before any button uses it, for example to `event-space-half-day`. If there is no field, click **Add slug** and type one.

![The Slug row with the storefront address in front of a typed slug, the Primary chip beside the field and Add slug under it](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-link-your-website-to-the-storefront-03.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=674014ba028757c7737447ef06c40bce)

**4. Save the slug**

If you changed the slug, click **Save changes** in the bar across the top of the page. The bar closes and the field keeps the new slug.

![The save bar across the top of the listing, with Save changes highlighted](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-link-your-website-to-the-storefront-04.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=c1753328eda165c5f93c5eb799399c53)

**5. Put the link on your button**

In your website builder, set the button's link to the address in front of the field followed by the slug, such as `https://book.yourbrand.com/products/event-space-half-day`. Switch off the builder's option to open the link in a new tab, then publish your website.

![The Slug field with the storefront address and the slug highlighted separately, the two halves of the link](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-link-your-website-to-the-storefront-05.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=26450a9084470e682ec0a5a14ddeecfb)

**6. Test the button**

Click the button on your published website, on a phone as well as a computer. The listing's page opens on your subdomain in the same tab, with its name at the top and its options to book or buy. Checkout runs on the same address.

![The listing's page on the storefront, with its name at the top and the Buy for button highlighted](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-link-your-website-to-the-storefront-06.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=a97331ca7df9bbf412df297d6f14aea8)

## How do I know it worked?

* **The button opens the listing's page** on your subdomain, not on a twice.shop address.
* **The page opens in the same tab**, so the browser's back button returns to your website.
* **A test order placed from that page** reaches checkout on the same address and shows in **Orders**.

## Troubleshooting / common pitfalls

> [accordion] The button opens a page that is not found
>
> The listing is no longer on sale in the online store, or the slug in the link was changed or removed. Every slug in the list keeps opening the listing, so add the old slug back with **Add slug**. See [Where a listing sells](https://www.twicecommerce.com/docs/guides/sales-channels/control-where-a-listing-sells.md) and [Listing marketing and SEO settings](https://www.twicecommerce.com/docs/catalog/listings/marketing.md#url-slugs).

> [accordion] The address in front of the slug ends in twice.shop
>
> Your subdomain is connected but not primary. Choose **Set as primary** on its row under **Settings → Domains**. See [Domains](https://www.twicecommerce.com/docs/settings/domains.md).

> [accordion] Customers cannot get back to your website
>
> Add your website to the storefront header. In the theme editor's **Header** block, click **Add external link**, enter your website's address and switch off **Open in new tab**. See [Pages and navigation](https://www.twicecommerce.com/docs/guides/sales-channels/storefront-pages-and-navigation.md).

## Related articles

> [card] [Online Store](https://www.twicecommerce.com/docs/concepts/sales-channels/online-store.md)
>
> How the storefront is served, and the pages it is made of.

> [card] [Listing marketing and SEO settings](https://www.twicecommerce.com/docs/catalog/listings/marketing.md)
>
> Slugs, page titles and share previews, field by field.

> [card] [Set up the online store](https://www.twicecommerce.com/docs/guides/sales-channels/set-up-the-online-store.md)
>
> Connect your subdomain and make it primary.

> [card] [Pages and navigation](https://www.twicecommerce.com/docs/guides/sales-channels/storefront-pages-and-navigation.md)
>
> Wire the header and footer, including a link back to your website.

> [card] [Design the storefront](https://www.twicecommerce.com/docs/guides/sales-channels/design-the-storefront.md)
>
> Match the storefront's logo, colours and type to your website.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.