Skip to main content
All CollectionsB2B HandsfreeCustomization
Customize the messages on the B2B Handsfree registration form
Customize the messages on the B2B Handsfree registration form
Updated this week

Note: These instructions are only relevant if you're using B2B Handsfree's app block with an Online Store 2.0 theme. If you're using a legacy theme, instructions for customizing the texts shown on B2B Handsfree's registration page are here.


Shopify currently does not allow merchants to customize texts stored in app blocks. This includes the messages shown on B2B Handsfree's registration page, for example the error message that is shown when a user tries to register using an email address that's already taken.

To get around this limitation, we've implemented a workaround that allows you to override B2B Handsfree's default message texts. You can do this by storing your own texts in metafields, which will then be used instead of the default texts stored in the B2B Handsfree app block.

The first step is to install a 3rd-party metafields app. This is necessary because Shopify currently does not have a native way to edit metafields on the shop resource, which is where the B2B Handsfree metafields need to be created. We recommend Metafields Guru, the free version includes all the functionality you will need to follow these instructions.

Once you've installed Metafields Guru, access the app in your store's admin and click on the big Shop button in the app's dashboard:

This opens the page where you can edit metafields for the shop resource. You can create the following three metafields.

Email already taken error

This error is shown when a customer tries to register using an email address that's already taken. To override the default message, create a rich text metafield with a namespace of a9design_b2breg and a key of message_email_taken and enter your custom message in the text field.

General error message

This is a general error message that is shown in all other error cases. To override the default message, create a rich text metafield with a namespace of a9design_b2breg and a key of message_failed and enter your custom message in the text field.

Success message

This message is shown when registration was successful. To override the default message, create a rich text metafield with a namespace of a9design_b2breg and a key of message_successful and enter your custom message in the text field.

Be sure to enter the namespace and key exactly as listed above, otherwise it will not work and B2B Handsfree will show the default messages.
​

When any of these metafields are present, B2B Handsfree will show the text contained in them instead of the default text stored in the app block. If your store is multilingual, you can use your usual translation app to translate these metafields, just like you would translate any other metafields.
​

Did this answer your question?