All Collections
Shopify Subscription App
Setup and Getting Started
How to customize text or add translations in Shopify
How to customize text or add translations in Shopify

If you want to change, edit, or translate the text relating to subscriptions, this guide will show you how to do it.

Ryan P. avatar
Written by Ryan P.
Updated over a week ago

The PayWhirl Shopify app can be translated into many different languages, and you can find the translation page in the app under Settings > Manage Translations.

Most subscription-related text can be customized or translated in this section. The default dropdown can be used to change text in the main language of your Shopify store. If needed, you can use that dropdown to configure translations for multiple languages.

There is some subscription-related text that is controlled in your theme and the Shopify language editor. This is mainly the part that shows during checkout. For example, the subscription policy checkbox can be customized in your theme's translation section.

Please note, if you are using the older widgets that don't utilize the shopify app blocks, you will need to edit your theme files to adjust some text.

See below for details:

These two translations for 'purchase options' and 'one-time purchase' are located in your theme files and are located in paywhirl-settings.liquid and can be adjusted as needed.

By default, you'll see two transactions, one for English and another for Polish, but you can add additional languages by adding additional values to the code. For example, if you wanted to add another translation for Italian, you would edit the code as follows.

* Translations
translations: {
en: {
'plan-selector-title': 'Purchase options',
'one-time-purchase-label': 'One-time purchase',
it: {
'plan-selector-title': 'Opzioni di acquisto',
'one-time-purchase-label': 'Acquisto una tantume',
pl: {
'plan-selector-title': 'Opcje zakupu',
'one-time-purchase-label': 'Jednorazowy zakup',

You can add as many new blocks as you need. You just need to find the two-digit language code and then add the translations for that language. It's usually easiest to copy the first language block (English) and then paste it again below the closing }, for that language block.

For Italian, the block looks like this...

    it: {
'plan-selector-title': 'Opzioni di acquisto',
'one-time-purchase-label': 'Acquisto una tantume',

For Spanish, it would look like this...

    es: {
'plan-selector-title': 'Opciones de compra',
'one-time-purchase-label': 'Compra única',

Don't forget to check your Shopify theme's language settings. You'll find some other text that may need to be translated. These are controlled within Shopify's language editor and located in your Shopify account under Online Store > Theme > ... > Edit default theme content.

You can search for any text that is not translated and adjust it as necessary. For example, if you search "subscription", you should see all of the text related to subscriptions now available in Shopify.

It is rare, but you may find a missing translation in the customer portal where a return link doesn't show up properly. This is likely due to using a very old version of a theme that doesn't have these elements



The beginning two letters specify the language, so the above example was for English. The example below is for Italian.



You can add these to your theme if they are not present under the "Locales" folder in the corresponding language JSON file. For example, if the English translation is missing, you would open the en.default.json file to make sure they are present.

If you need assistance or have questions, please don't hesitate to contact our team. We are happy to help and answer any questions.


The PayWhirl Team

Did this answer your question?