Credential Languages

You write a group’s title and description, and your email template, once, in your own language. You can then add translations, made by AI or written by you. Hyperstack picks the right one by itself:

• The credential page shows the group’s text in the visitor’s language.
• The credential email goes in the recipient’s language, when your email template has a translation in it.

Hyperstack speaks 14 languages: English, Arabic (العربية), German (Deutsch), Spanish (Español), French (Français), Irish (Gaeilge), Hindi (हिन्दी), Italian (Italiano), Korean (한국어), Portuguese (Português), Russian (Русский), Swahili (Kiswahili), Tamil (தமிழ்) and Chinese (简体中文).

​

Set your default language

The default language is the language you write in. It is English unless you change it. The default language doesn’t change or translate your text. It tells Hyperstack what language your text is in. Write your email templates in the default language too.

​

A group in another language

If one group is written in another language, for example a French course, set that group’s own language.

1. Open the group. Under More settings, open General settings.
2. Choose its Language. Organization default uses your default language.
3. Click Update group.

The group’s language is also used for its credential emails when Hyperstack doesn’t know the recipient’s language. See Which language an email goes in.

​

Translate a group’s text

Translations save at once. Credential pages use them, also the pages of credentials you issued before. The AI keeps your formatting, such as bold text and lists. Names of people, brands and courses can still change. Ask someone who reads the language to check the translation, and edit it if needed.

​

Translation states

​

Edit a translation

Click Edit, change the title or the description, then click Save translation. The translation is now Edited. To go back to the AI’s translation, click Reset to automatic. AI translates the original again and replaces your edit.

​

When you change the original

When you change the group’s title or description:

• Auto translations become Out of date. Visitors no longer see them. Click Translate to make a new one.
• Edited translations become Check. Visitors still see them. Open each one and click:
  • Mark as checked if the translation still fits.
  • Use new translation to replace it with a new AI translation.
  • Edit to change it yourself.

​

What visitors see

The credential page follows the visitor’s language: the one they chose at the bottom of the page, or else their browser’s language. The page’s own words were already translated. Now the group’s title and description are too.

• A translation is saved: the page shows it at once, with Translated · Show original. Also in lists the other languages the group has, to switch by hand.
• No translation is saved: the page shows your original with a Translate button. AI translates the text for the visitor, and Hyperstack saves it. Later visitors see it at once, and it shows as Auto in your Translations panel. You can edit it there.
• The visitor reads the group’s language: the page shows your original.

Visitors who read the group’s language see the page as before. When the group has translations, the page also shows the Also in line.

​

Send the email in the recipient’s language

The whole email goes in one language: the subject, your text, the buttons, the footer and the dates. For this, the group needs your own email template, with a translation in that language. The built-in default email is in English only.

​

Translate an email template

​

Preview the email in a language

Preview in, above the email, shows the saved template in another language: your translated text, our buttons and footer, and the date. If the template has no translation in that language, the preview says so. That email goes out as written.

​

Which language an email goes in

Hyperstack takes the first language it has from this list:

1. The credential’s language, when you set one. See Choose a credential’s language.
2. The recipient’s own language. Hyperstack learns it when the recipient:
   • chooses a language in their wallet, or
   • clicks a language in the Read in line of an email, or
   • opens a credential from an email’s button. Their browser’s language is used only if nothing else is known.
   It is kept for the email address, for every organization that issues to that address.
3. The group’s language.
4. Your default language.

If your template has a translation in that language, the email goes in it. If not, the email goes as written, as it did before. When the template has at least one translation, the email starts with a Read in line. It lists the email’s language and the other languages of the template. A click opens the credential page in that language, and the recipient’s next emails go in it. [group_title] and [group_description] in the email use the group’s translation in the email’s language, when it has one.

​

Choose a credential’s language

Most of the time you can leave it on Automatic. Set a language when you know what the recipient reads, for example for a course taught in Spanish.

​

When you issue

• Add by hand: under the recipients, click change next to Language: Automatic, and choose a language. It is used for every recipient you type in.
  
• Upload a spreadsheet: add a column named Language to your file, with a language for each row. Use a code such as fr, or a name such as French or Français. Leave a cell empty for automatic. The column is not in the CSV and Excel templates: add it yourself. The Studio matches the column by itself only when every value in it is a language. Otherwise, match it under Match columns. A row with a value that is not a language is marked: fix it before you continue.
• API and AI assistants: send language. See Use the API or an AI assistant.

Credentials that apps issue for you, such as Moodle, LTI, forms or Zapier, are automatic.

​

After you issue

Open the credential, click Edit details and change Language. Then Resend invitation to send the email in the new language. Once you set a credential’s language, or give a group a language other than your default, the Credentials table has a Language column and a Language filter. Credentials without a language show Automatic.

​

Where the credential’s language shows

When a credential has a language, these use the group’s translation in that language:

• The group title and description on the certificate and badge, through [group_title] and [group_description]. The other words on your design stay as you designed them.
• The title of Add to LinkedIn Profile.
• The name and description in the Open Badges downloads, which also say the language.
• The title and description that search engines and link previews show.

For an automatic credential, all of these stay in the group’s language, as before. In the wallet, recipients see credential titles in the language they chose there, when your group has a translation in it.

​

What is not translated

• Skill and knowledge tags
• Transcripts
• Fixed words on a design
• Google Wallet passes
• Your showcase page and pathways
• The built-in default email

​

Language codes

​

Use the API or an AI assistant

• Issue Credential and Generate Credential take an optional language: a code such as fr, or a name such as French. Leave it out, or send it empty, for automatic. An unknown value returns 400 with invalid_language, and no credential is made.
• The MCP server takes language on each row of issue_credentials and on update_credential.

​

Limits

• AI can’t translate a text longer than 12,000 characters. Write that translation yourself.
• Each team member can translate a limited number of times a minute and a day. Visitors’ Translate buttons have their own limit. When a limit is reached, try again later.
• If a translation fails, nothing is saved. Click Translate again.