Shopify SSO Login
Learn how your customers can log into their Self-Service Center using their Shopify credentials.
Your customers can log into their Firmhouse Self-Service Center (SSC) using their Shopify username and password. This functionality is included as part of the default Firmhouse Shopify app installation. There are three ways to set this up depending on your Shopify account type and theme.
Option 1: Legacy Themes (Theme Code Edit)
This option is for merchants using Shopify legacy accounts and a theme that is compatible with the legacy account system.
To set up SSO login, you'll need to add a redirect link in your store by editing some HTML of your online store. There are two approaches depending on your needs:
Customers use both the Shopify account page and the Firmhouse SSC.
Customers only use the Firmhouse SSC.
Both approaches start with the same steps:
Log into your Shopify store admin page
Click on Sales channels > Online Store
For your Current theme, click on Customize
In the header click the three dots > Edit code
Find the file customers/account.liquid in the templates folder
Choose how you want to set up the redirect based on your preferred customer experience.
Styling Error Messages
If a customer is redirected to /a/firmhouse but cannot be logged into the Firmhouse SSC (due to either their email not being found within your Firmhouse project or not being logged into their Shopify account), an error message will be displayed in English. We've added a unique FH-SSO--not-logged-in class to this error message, enabling you to easily target it with custom CSS and style it to seamlessly match your store's design.
We also display a separate error message for technical issues, such as when the app is not correctly installed or configured. We've added a unique FH-SSO--error class to this message, allowing you to target and style it separately.
Option 2: New-Style Themes and Accounts (Account Portal Extension)
This option is for merchants using new-style Shopify themes like Shopify Horizon and new-style Shopify accounts.
For these setups, you can add an extension in the account portal on the Orders page to show a "Manage Subscription" block to customers. When customers click this block, they will be automatically logged into the Firmhouse Self-Service Center.
This approach requires no theme code editing and provides a seamless experience for customers using the modern Shopify account system.
Option 3: SSO Bridge URL (Universal)
As an alternative that works for all store types, you can point customers directly to the special Shopify SSO bridge URL:
This URL will automatically log customers into the Firmhouse Self-Service Center regardless of whether your store is using legacy accounts or new-style accounts.
This is a good option if you want to include a direct link to subscription management in your emails, navigation menus, or other customer touchpoints.
How to Test the Integration
After setting up one of the options above, you can test the integration by logging into your Shopify store with an email address that has an active subscription in Firmhouse. Once logged in, you should be able to access the Self-Service Center through whichever method you configured.
Last updated