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

# Membership plans

> Show available membership plans on any page

The membership plans app block displays your membership plans as cards on your storefront. This is the **only correct way** for customers to enroll in memberships—purchasing plan products directly will not work.

<Warning>
  **This block is required for membership enrollment**

  Customers must enroll through this app block. If they purchase plan products directly (e.g., via URL), the membership won't activate properly and features like swapping and plan management won't work.
</Warning>

## How it works

The membership block:

1. Displays your membership plans as cards with pricing and details
2. Shows an "Add to cart" button for each plan
3. Handles the proper enrollment flow when customers click the button
4. Ensures Supercycle activates all membership features correctly
5. Connects the customer to Supercycle for plan management

After enrollment, customers can navigate to any product with membership enabled and rent it using their credits.

## Adding the block

<Steps>
  <Step title="Create a collection with plan products">
    First, create a collection in Shopify and add your membership plan products to it. This collection controls which plans appear in the block.

    See [Plans setup](/documentation/methods/membership/plans-setup#create-a-membership-page) for detailed instructions.
  </Step>

  <Step title="Add the block to your theme">
    1. Go to **Online Store > Themes > Customize**
    2. Navigate to the page where you want to display plans (or create a new page)
    3. Click **Add section** or **Add block**
    4. Select **Supercycle - Membership plans**
    5. In the block settings, select the collection you created
    6. Click **Save**
  </Step>
</Steps>

## Multiple blocks for different audiences

You can add multiple membership blocks to display different plans to different audiences:

**Example: Customer vs Business plans**

* Create a "Customer plans" collection with 3 plans for individuals
* Create a "Business plans" collection with 3 plans for businesses
* Add two membership blocks to the same page (or different pages)
* Connect each block to its respective collection

This gives you full control over which plans appear where on your storefront.

<Info>
  **Adding plan descriptions**

  To add a description to a plan, find the plan product in Shopify admin and add the description there. It will automatically display in the membership block.
</Info>

## Messages for existing members

When a logged-in customer already holds a membership, the block can show a note on each plan card before they add another plan to cart. Set these in the theme editor under **Button settings** on the **Membership plans** block:

| Setting                          | When it shows                                                 |
| -------------------------------- | ------------------------------------------------------------- |
| **Already on this plan message** | The customer already holds an active membership on this plan. |
| **Already a member message**     | The customer holds active memberships on other plans.         |

Defaults explain that buying the plan adds another membership. Leave either field blank to hide that message.

In **Already a member message**, use `[current_plan_title]` where you want the customer's newest active plan name to appear.

If you use a custom card layout, add `[plan_existing_membership_message]` to the **Template** field to place the note where you want it. When the template does not include that placeholder, the message still appears below the button on the default layout.

Customers can add only one membership plan to cart at a time. The add button stays disabled when a plan is already in cart.

## What happens at checkout

When a customer enrolls in a membership and rents products:

1. **Enrollment**: The customer adds a membership plan to cart and completes payment
2. **Activation**: Supercycle activates the membership and assigns credits to the customer's account
3. **Browsing**: The customer can now browse your store and view products eligible for membership
4. **Adding to cart**: When they add an eligible product to cart, they can see it will use membership credits
5. **Checkout**: When they complete checkout, credits are automatically deducted from their membership balance
6. **Returns**: When customers return items, credits are immediately added back to their account for future rentals
7. **Management**: The customer can manage their membership, view credit balance, and track rentals through the profile dashboard page

## Styling

The block inherits your theme's styling but can be customized using CSS variables or by editing the block's appearance settings in the theme editor.