If your store is still using a legacy OS 1.0 theme with Liquid templates, you need to manually set up the registration page and the corresponding page template, because due to more restrictive Shopify policies introduced in early 2024, our app cannot do this for you automatically.

Please note that B2B Handsfree's registration page can only be set up on your store's LIVE theme, NOT on an unpublished theme. If you want to set up B2B Handsfree on a currently unpublished theme you need to first publish the theme before you can set up B2B Handsfree's registration page.

The setup consists of three parts:

Please perform the following steps exactly as detailed below. If you're unsure of anything or get stuck, feel free to open a support ticket.
​

After installing the B2B Handsfree app on your store and setting basic configuration options, you should see the app's dashboard. Clicking on the Setup page button will open a page with the code snippet you need for creating the B2B Handsfree registration page template on your store's theme.

Make sure you're on the Page Template tab:
​

Click the link in the first instruction step to open the theme code editor in a new browser tab:
​

Inside the theme code editor, click Add template in the navigation sidebar:

In the popup dialog, select Page from the template type dropdown, select the liquid option and give the new template the name b2bapp.

Then click Done.
​

Now select the entire contents of the newly created template and delete it, so that you end up with an empty template like so:

Then go back to the instructions page in B2B Handsfree and click the Copy template code button in step 2:

Then go back to the code editor and paste the code into the code editor:

Then click the Save button:

In this part we will update your theme's language files to add B2B Handsfree's text strings. If you've set up your store to be available in multiple languages, you will do this for each language B2B Handsfree supports.

Even if your store isn't available in English, you have to first update the language file for English. You can update additional language files after you've updated the one for English.

On the setup instructions page, click the Language Files tab:

Make sure English is selected in the dropdown menu:

Click the button Copy language code to copy the necessary code to the clipboard:

Then click the Open language file in theme code editor button:

This will open the language file corresponding to the selected language in the theme code editor. For English, this is the file en.default.json.

With this file open in the code editor, select the entire contents of the file.
​

Then delete the code so you end up with an empty file like so:

Then paste the code you just copied into the file:

Then click Save:

If your storefront is available in languages other than English, first select the respective language from the dropdown:

Then repeat the above steps for each additional language.

In this final part of the setup you need to create a new page on your store and assign the template your created in part 1 to it.

In the navigation sidebar of the Shopify admin, click Online Store and then Pages:

Click the Add page button:

Give the page a title, for example "B2B Registration" and select the b2bapp theme template:

Then click Save:

You should be able to view the B2B Handsfree registration page by clicking View page: