Commonplace
Setting it up
For the Commonplace HSA/FSA Letters app for Shopify. Last updated 7 August 2026.
Three steps. Choose which products qualify, add two blocks to your product template, and you are done. There is no theme code to edit and nothing to paste.
1. Choose which products qualify
Open the app and go to Eligible products. Your catalogue is imported and scored, so likely candidates — saunas, cold plunges, recovery and fitness equipment above a minimum price — are suggested first. Tick the ones you want to offer and submit them.
A Commonplace reviewer then approves each product and attaches the health conditions that could justify it. That review is what a clinician sees later, so it is also what protects you: nothing appears on your storefront until it has been approved.
2. Add the two blocks to your product template
The app home has a button that opens your theme editor with the block ready to place. If you would rather do it by hand, or the button is not available on your theme:
- In your Shopify admin, go to Online Store → Themes and choose Customize on your live theme.
- Switch the template selector at the top from Home page to Products → Default product.
- In the Product information section, choose Add block, open the Apps tab, and add HSA/FSA badge.
- Add Use HSA/FSA funds the same way, and drag it below the add-to-cart button.
- Save.
Both blocks hide themselves on products that have not been approved, so you can add them once and leave them there. As more of your products are approved, they simply start appearing.
This needs an Online Store 2.0 theme — any theme that supports app blocks, which includes every theme in the Shopify Theme Store. If your theme is older, email us and we will help.
3. Watch requests come in
When a shopper uses the button, their request appears under Applications in the app with a reference code and a status. That is all you see — no health questionnaires, no conditions, no letters. If a customer asks you about their request, ask for their reference code.
What your customer sees
On an approved product they see a small “HSA/FSA eligible” badge and a button. The button opens Commonplace in a new tab, so your product page is never navigated away from, and the copy says plainly that they should complete their purchase with you as normal.
From there they answer a short medical intake on Commonplace, a clinician licensed in their state reviews it, and a signed letter is emailed to them if the clinician can support the request.
If something is not working
- No badge on a product. It has probably not been approved yet — check its status under Eligible products. The blocks deliberately render nothing on unapproved products.
- No badge on any product. The blocks are most likely not on the template you are looking at. Product pages can use more than one template; add the blocks to the one that product uses.
- Everything has stopped at once. Check Settings for the pause switch — it hides every badge without touching your theme, and it may simply be on.