Quick install on Shopify
All the steps you need to follow to integrate Firmhouse with your Shopify store.
This guide explains all the steps that you as a merchant (in combination with your agency/developer) need to do, to get started with selling subscriptions via Shopify Native Checkout powered by Firmhouse.
Prerequisites
Before you begin, make sure you have:
A Shopify store (could still be under development)
Let's get started with installing the Firmhouse App in your Shopify store!
Step 1: Install the Firmhouse App in Your Shopify Store
Ensure you're logged into your Shopify store
Go to the Firmhouse app on the Shopify app store and click Install
Verify and confirm the installation of the Firmhouse app on your store. Once installed, you will end up in the Firmhouse Portal, and you can continue with the next steps
In your Firmhouse project, you have a Getting Started menu with a video guide. The guide follows the same steps as this article, so you can also follow the video if that format works better for you.
Step 2: Sync Your Products from Shopify to Firmhouse
You control which products and variants you want to offer for subscription. To sync your catalog, simply tag your products in Shopify:
Tag subscription products with
FIRMHOUSE_SUBSCRIPTIONIf you also want to offer one-time subscription add-ons in the Firmhouse Self Service Center, tag these products with
FIRMHOUSE_ONE_TIME
When tagged, your products will automatically show up in the Products tab of the Firmhouse portal.
Step 3: Create Your Subscription Plans in Firmhouse
In Firmhouse, go to Plans from the sidebar. Here, you can set up different shipping frequencies for your subscribers - for example, "Every 2 weeks" or "Every 2 months." These plans will appear to customers when they add products to their cart or manage their subscriptions on the My Account page.
You can also set a discount percentage for each plan. This percentage determines the final product price for customers who subscribe to it.
If you want to offer the same selling plans for all your subscription products, you may create your plans in the Ungrouped plans section.
However, if you want to have specific plans apply to specific products (collections), we advise you to create Selling plan groups first and then create plans for each selling plan group.
Once your plans are created, they will automatically sync to your Shopify store. Note that it may take a few seconds before the changes appear in Shopify.
You can then proceed with adding the "Add subscription to cart" interface on your product detail pages in the next steps.
Step 4: Add or Build Subscription Options on Your Product Detail Pages
Now it's time to add the subscription options to your product detail pages, so your customers can add them to their cart. There are two ways to do this:
Use one of the standard Firmhouse Subscription Options widgets (for Shopify 2.0 supported themes)
Build or modify your existing custom subscription widget
Option 4.1: Add the standard Firmhouse Subscription Options widget (recommended)
In the Shopify theme editor, select the Product template page you want to edit. For example: Products > Default product
In the sidebar under Template in the Product information, click Add block
Switch to the Apps tab in the Add block section and click Subscription Options or Subscription First widgets
If you want, customize your widget to match your branding
Option 4.2: Build a custom subscription widget
If you have specific wishes for your subscription widget that the Firmhouse standard widget does not cover, you can also build your own.
Done!
Go to your store, add a subscription option to the cart, and enjoy checking out the subscription products with Credit Card or PayPal. The subscription should appear in the Customers overview in the Firmhouse Portal shortly after.
Next steps for European merchants
If you need to do business in Europe and want to offer local payment methods like iDeal, Bancontact, and SEPA Direct Debit, continue with the Set up iDeal, SEPA and other local payment methods guide.
Last updated