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.
Additionally, it's important to understand the division of responsibilities between Shopify and PayWhirl. Shopify controls the broader customer account portal, including most text and translations, while PayWhirl manages only the "Subscriptions" section within the customer account portal. The label for this section (e.g., "My Subscription") is derived from your Shopify theme or navigation settings.
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:
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',
},
Managing Language Settings for Shopify's Customer Account Portal
When managing language settings for Shopify's customer account portal and PayWhirl subscriptions, it's essential to use Shopify's translation tools for the broader portal and PayWhirl's settings for the "Subscriptions" section. This ensures a seamless multilingual experience for customers.
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.
For example, if you need to change the label for the "Subscriptions" section (e.g., "My Subscription" or "Votre Abonnement"), you can do so by navigating to Online Store > Themes > ... > Edit default content in your Shopify Admin. Search for terms like "Subscription" or "Manage subscription" and update them as needed. This ensures the "Subscriptions" menu label appears in the desired language.
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 the return link doesn't appear properly. This is likely due to using a very old version of a theme that doesn't have these elements
This issue highlights the importance of distinguishing between Shopify's and PayWhirl's responsibilities. Shopify manages the overall customer account portal, while PayWhirl focuses on the "Subscriptions" section. Missing translations in the customer portal are often related to Shopify's settings rather than PayWhirl.
en.customer.account.return
en.customer.account.title
The first two letters specify the language, so the above example was for English. The example below is for Italian.
it.customer.account.return
it.customer.account.title
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.
Sincerely,
The PayWhirl Team