> This page is for version v1 (default).
> For other versions, use one of these documentation indexes:
> - v1 (default): https://developers.truemed.com/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.truemed.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.truemed.com/_mcp/server.

# Checkout messaging for subscription products

> How to add an HSA/FSA checkout banner for subscription products using the Shopify Checkout Blocks app.

If you sell subscription products through Shopify and use Truemed's **qualification link** to support HSA/FSA eligibility, we recommend adding approved Truemed messaging directly to your **Shopify checkout page**. This ensures customers understand how to complete the qualification process and take advantage of potential tax savings.

![Checkout messaging example](/_fern-img/6952d07e32aabe0cf29640e7af65c536cb742926ac8e7d78758d49d795d647ee.webp)

---

## Why add checkout messaging

Because subscription items require customers to complete the Truemed qualification and reimbursement process after purchase, clear expectations at checkout are especially important. This recommendation focuses on adding a lightweight checkout banner that informs customers how to take advantage of potential HSA/FSA tax savings post-purchase.

---

## The solution: Checkout Blocks

**Checkout Blocks** is a widely used Shopify app that allows Shopify stores to conditionally display custom messaging and content directly within checkout. Many Shopify stores already use it to manage banners, disclaimers, and dynamic checkout content, and you may already have it installed. If not, installation is quick and does not impact existing checkout functionality.

We recommend using Checkout Blocks to display a conditional banner during checkout when a cart contains a subscription item (i.e. an item with a selling plan).

This approach is:

* Fast to implement
* Non-disruptive to checkout
* Dynamically shown only when relevant
* Works for all Shopify pricing tiers

---

## How to add HSA/FSA messaging at checkout

### Step 1: install Checkout Blocks (if not already installed)

1. From your Shopify Admin, go to **Apps**
2. Visit the Shopify App Store
3. Search for Checkout Blocks
4. Install the app and follow Shopify's installation prompts

Once installed, Checkout Blocks will be available within your checkout customization tools.

### Step 2: create the Truemed checkout banner block

#### Create a block

1. Click on Checkout Blocks on the left side navigation of your Shopify dashboard

2. Create a Dynamic Content Block

   ![Checkout Blocks dynamic content option](/_fern-img/e429db13103960b3e4fbda2a74bdef5f87a3422914b422272589ae513c61d0fa.webp)

   ![Creating a new block in Checkout Blocks](/_fern-img/33a351baf58792b5aa0ec30d1943e84154dd4d14e6bf3b5f5f9259e915c96c20.webp)

3. Select Banner Example

   ![Selecting the banner example template](/_fern-img/a76c5064ceda8e67e5e33a5d03578d385cf5bc102f89d5ebf801e3583a11d8ff.webp)

4. Add a Block Name, limit the Publishing Region to United States, and create a Display Rule so the contents will only display when any single line item has a selling plan

   ![Configuring display rules for subscription items](/_fern-img/67f8b2643829c18028aa165176d178e049dba8e620906824484118ce214134cd.webp)

5. Click "Edit" in the Content Items > Banner section and input the Banner Copy with the Banner Status "Plain banner"

   #### Banner copy (use exactly as written)

   **Title**

   > Save an average of 30% when you use your HSA/FSA funds through Truemed.

   **Content**

   > Once you've purchased, fill out the Truemed health intake form on your order confirmation page to check if you qualify for HSA/FSA reimbursement.
   >
   > HSA/FSA tax savings vary. Learn more at [truemed.com/disclosures](https://www.truemed.com/disclosures).

6. Save your changes in the top bar of your Shopify dashboard

   ![Saving changes in Shopify](/_fern-img/6952d07e32aabe0cf29640e7af65c536cb742926ac8e7d78758d49d795d647ee.webp)

7. Follow the Setup Guide to set the block as active and add it to checkout

   ![Checkout Blocks setup guide](/_fern-img/decab0af28ae9e9c912adf43fbfb69f6cf6c8920cf8b2b428118a67ed4405588.webp)

   ![Activating the checkout block](/_fern-img/dde1b77cab45a46cdb6982c5e29c02fa5124c3b2353b8f2e36cab7f55ebe43f0.webp)

> **Note**
>
> If you used a different Block Name or Block ID, your instructions here may look slightly different. Make sure you follow the customized instructions provided in your app.

8. Open the editor and add a Dynamic Content block to Checkout

   ![Adding dynamic content block to checkout editor](/_fern-img/728040c33d97b9f85df37ac21a4e3aa47babc64ca9071dae33f743d4c9d1256b.webp)

9. Use the Block ID referenced in Step 7 to add your custom block to your Checkout page

   ![Entering the Block ID in the checkout editor](/_fern-img/53a386c9852002076fa3167987e5aa91f6cedca370c9f1a04551d2d987828d1b.webp)

> **Warning**
>
> You won't see the new copy unless you input the Preview Block ID. Make sure you remove this ID before saving the block -- your customers will see the contents at checkout even though you can't see it in the editor.

10. Click **Save** in the upper-right of the window.

---

## What customers will see

When a customer checks out with a subscription item:

![Customer view of HSA/FSA messaging at checkout](/_fern-img/6952d07e32aabe0cf29640e7af65c536cb742926ac8e7d78758d49d795d647ee.webp)

---

## Need help?

If you have questions about adding checkout messaging or need implementation support, contact Truemed's merchant support team at [merchants@truemed.com](mailto:merchants@truemed.com).