Keystone Documentation

Appearance

Adding Translations ​

There are two ways to add translations to your loyalty content.

Option 1 — While Creating or Editing Content ​

This is the most common way. When you open any reward, earning rule, or tier to create or edit it, each text field has a small "Add locale" button next to it.

Here is what the experience looks like:

  1. You type the content in your default language as normal (e.g. "Gold" in English)
  2. Click "Add locale" next to that field
  3. A panel opens — your default language is already shown at the top
  4. Click "+ Add locale" and select a language from the dropdown (e.g. French)
  5. A text field appears for French — type your translation (e.g. "Or")
  6. Click "+ Add locale" again to add more languages (e.g. Spanish → "Oro")
  7. Save the content as you normally would — translations are saved along with it

The button label updates to show how many translations exist for that field. For example, if you have added French and Spanish, it shows "Locales (2)".

You can go back and add, edit, or remove translations at any time by clicking the button again.

Option 2 — From the Translations Settings Page ​

If you want to manage all your translations in one place, go to Settings → Translations.

This gives you a central view of every translatable key across your loyalty program. From here you can:

  • See all existing translations at a glance
  • Edit any translation value for any language
  • Add custom translation keys for additional content (content not covered by the standard fields)
  • Delete custom translation keys you no longer need

This is useful if you want to do a full translation pass across your entire program without opening each reward or rule individually.

A Real Example ​

Say you have a VIP tier called "Gold" and a reward called "Free Shipping", and your points are called "Stars".

After adding translations, here is what different customers would see:

ContentEnglishFrenchSpanish
Tier nameGoldOrOro
Reward nameFree ShippingLivraison GratuiteEnvío Gratis
Points nameStarsÉtoilesEstrellas

A French customer visiting your storefront sees "Or", "Livraison Gratuite", and "Étoiles" — all without doing anything themselves.