> For the complete documentation index, see [llms.txt](https://crushsuite.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://crushsuite.gitbook.io/docs/clubs/getting-started/setting-up-your-club-product-template.md).

# Setting Up Your Club Product Template

Build a dedicated club product template, add the signup widget to it, and assign it to your club product. Takes about 10 minutes.

{% hint style="info" %}
**Next:** [Setting Up Your Club Product Page](/docs/clubs/getting-started/setting-up-your-club-product-page.md)
{% endhint %}

***

### Before you start

* Your club already exists (Phase 1) — the signup widget has nothing to render otherwise.
* Your theme is Online Store 2.0. App blocks can only be added to sections on Online Store 2.0 themes, so if **Add block** isn't offered, that's the reason.
* You'll be editing your published theme. If you'd rather work safely, duplicate the theme first and publish it once you're happy.

***

### Step 1: Create a club product template

Don't add the signup widget to your default product template — that template is shared by every product in your store. Club memberships get their own.

1. Open **Shopify Admin** → Online Store → Themes → Customize.
2. In the template picker at the top of the editor, choose **Products** → **Default product**.
3. Click **Create template**.
4. Name it something you'll recognise — `club-signup` works. Base it on the default product template.
5. Shopify creates the template and switches the editor to it.

The name you choose becomes the template's suffix. `club-signup` produces a file called `product.club-signup.json`, and CrushSuite shows it as `club-signup` when you assign it.

***

### Step 2: Add the Club Membership Signup Widget to that template

**Club Membership Signup Widget** is an **app block** — app-provided UI you add to a section of a template.

1. With your new club template open in the editor, navigate the preview to your club product.
2. In the product information section, click **Add block**.
3. Choose **Club Membership Signup Widget**.
4. Check the block's **Product** setting. It auto-fills with the product currently in the preview, so confirm it names your club membership product.
5. Click **Save**.

***

### Step 3: Assign the template to your club product

The template exists, but nothing uses it until you point the club product at it.

1. Open **Shopify Admin** → Products and find the product named after your club.
2. In the **Theme template** section of the product page, select `club-signup`.
3. Click **Save**.

From your second club onward you can skip this step by picking the template in the **Theme template** field while you create the club — the field reads templates from your published theme, so the template has to exist first. That field never appears on your first club, which is why the assignment happens here.

{% hint style="warning" %}
The **Theme template** chosen during club creation can't be changed from CrushSuite afterward. Changing it later means changing it on the product in **Shopify Admin** → Products, as above.
{% endhint %}

***

### Step 4: Turn on Club Migration — only if you're importing members

**Club Migration** is an **app embed** — a toggle you switch on once, applying site-wide. It lives in a different part of the theme editor from the signup widget, which is why merchants regularly mix the two up.

If you're bringing members over from another platform, open **App embeds** in the same theme editor, find **Club Migration**, and toggle it on. Click **Save**.

Its one setting, **Skip cart and go straight to checkout**, defaults on. If you also run CrushSuite Compliance, turn this off so the pre-checkout compliance check can run first.

> 📸 **Screenshot:** The template picker in Online Store → Themes → Customize with a `club-signup` product template selected, and the Club Membership Signup Widget block added.

***

### What controls whether the widget appears

The signup widget renders only when its **Product** setting names a product CrushSuite has flagged as a club membership product — that flag is set when you create the club. Point the setting at an ordinary product, or add the block before the club exists, and nothing appears on the live storefront. In the theme editor only, you'll see a small warning banner instead: *"The Club Membership widget will only show on Club Membership products."*

The gate is the block's **Product** setting, not the page the block sits on. If nothing appears, check that setting first.

### What your member sees

The product page shows an address form and a **Sign up** button. Because the membership is digital, checkout has no shipping step at all — this on-page form is where the customer's shipping address is captured instead.

### How to check it worked

Open your club product's page on your live storefront, not in the theme editor.

| What to check                      | Working state                                                                                                                                    | Broken state                                                                                                     |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| The template is assigned           | The signup form renders on the live product page                                                                                                 | The page looks like an ordinary product page, with no signup form — the product is still on the default template |
| The block is on the right template | The form renders, with a working **Sign up** button                                                                                              | Nothing renders; the theme editor shows the "will only show on Club Membership products" banner                  |
| Club Migration                     | A member who opens their migration link lands on checkout with the membership already in their cart — or on the cart page, if the setting is off | The link lands on an empty cart, or on the product page with nothing added                                       |

{% hint style="info" %}
If the block or embed still isn't behaving as expected after following these steps, see [App Embed Not Displaying](/docs/clubs/troubleshooting/app-embed-not-displaying.md).
{% endhint %}
