Our Pick the Pair widget handles text and translations in two distinct ways. Understanding the difference will help you ensure your game displays correctly in any language.
π New to Pick the Pair? Make sure your game is set up correctly before diving into translations. Check out our How to Create Pick the Pair Games from Scratch guide.
π How does translation work in Pick the Pair games?
The Pick the Pair widget handles text and translations in two distinct ways:
1. Manual labels β Some text elements will display their pre-set default text values (which are in English) unless you change them yourself. These can be updated manually via the Labels field in the game editing page. This is intentional - we designed it this way to give you full flexibility. Regardless of what language you end up creating your games in, you can directly control and customize most of the text displayed in your game straight from the portal yourself. This means you no longer need to reach out to us and ask us to modify the widget to display things differently in your language!
2. Automatic translations β Other elements get translated automatically based on the Language property set for each game in the portal β no manual action needed. These include some small UI elements such as the lead form field labels (e.g., "Full Name", "Email") and the "Continue" button text displayed in some templates.
This article focuses on the manual labels: which UI elements require them, and how to update them.
π What Are Manual Labels Required For? Where Are They Displayed on the UI?
Whenever you create a Pick the Pair game, the following labels are pre-filled by default and visible in the Labels panel. You can edit any of them at any time:
- welcome β The welcome message displayed above the game board (default: "Welcome! Match the pairs correctly.")
- instructions β The instruction text shown inside the game board (default: "Select items from the left column to match with items on the right.")
- timeUp β The message displayed when the time limit expires (default: "Time is up!") If your game has no time limit configured, this message will not be displayed.
- successTitle β The message shown on the lead form once a user has finished the game and successfully submitted the form (default: "Congratulations!")
- successDescription β The description displayed right below the successTitle, once a user has finished the game and successfully submitted the lead form (default: "You successfully completed the game!")
- buttonLabel β The label on the call-to-action button (default: "Start Game")
- disclaimer β The disclaimer text shown at the bottom (default: "Terms and conditions apply.")
π Lead form title & description: You can control these too using leadTitle and leadDescription labels. These control the title and description text displayed at the top of the lead form β the default values being "Fill out and enter to win!" and "Fill out the form and enter the raffle to win an amazing prize!" respectively. Unlike the labels above, these are not pre-filled by default for now β you'll need to add them manually using the Key/Value fields at the bottom of the Labels panel. In the future, they will be pre-filled automatically just like the rest.
πΈ Visual Guide: Labels in Action
The screenshots below are taken from the landing page template of the Pick the Pair widget. Depending on which template you're using, the exact position of each label on screen may vary slightly β but the logic and the labels themselves remain exactly the same across all templates.
Creating A Pick-The-Pair game in English
When your game language matches the default label values, no manual changes are needed unless you'd like to customize the wording or make it more specific to your campaign. In this screenshot you can spot 3 of the 7 label-controlled elements: the welcome message above the game board, the instructions text inside it, and the buttonLabel ("Start Game") on the call-to-action button.
After completing the game and submitting the lead form, two more label-controlled elements appear: the successTitle & successDescription.
Once a user completes the game and submits the lead form, the success screen reveals two more label-controlled elements: the successTitle ("Congratulations!") and the successDescription ("You successfully completed the game!"). The disclaimer ("Terms and conditions apply.") is also visible here, though it appears throughout the game β not just on this screen.
Additionally, leadTitle and leadDescription can also be edited manually β these are not pre-filled for now but will be in the future. To add them, simply go to the Labels panel, and in the Key/Value fields at the bottom, enter either leadTitle or leadDescription as the key, and add the text you want to display as the value.
The screenshot below shows an example of a customised leadTitle and leadDescription in action on the lead form.
If a time limit is configured, the timeUp label is also displayed when the countdown reaches zero.
If your game has a time limit enabled, users will see the timeUp label ("Time is up!") overlaid on the game board when the timer expires. This is the 7th and final pre-filled label.
What happens if you create a game in any language other than English and forget to update the labels?
Since the default label values are in English, if you create a game in any language other than English and don't manually update the labels, those elements will simply remain in English β creating an inconsistency where part of your game appears in the correct language and part of it doesn't. To illustrate this, we created a game in Bulgarian as an example without changing the labels.
A game set to Bulgarian β labels have NOT been updated yet.
This is what happens when a game is set to any language other than English but the labels haven't been manually updated. Notice how the game content appears in Bulgarian, while all label-controlled elements β the welcome message, instructions and so on β remain in English, creating an inconsistency that will be visible to your users.
π‘ Whenever you create a game in any language other than English, make sure to always update the labels manually as well β this ensures a fully consistent experience for your users from start to finish
The Bulgarian game β after updating the labels.
Once the labels are updated in the Labels field, the welcome message and instructions now display correctly in Bulgarian, creating a fully consistent experience for the user.
The Labels panel after updating the welcome and instructions values to Bulgarian. The same should be done for all other labels to ensure full consistency.
β Frequently Asked Questions
π What are labels in Pick the Pair games?
Labels are text values that control specific UI elements within the Pick the Pair widget β things like the welcome message shown above the game board and the instructions shown to users. Because these are hardcoded in the widget, and the default values are in English, they must be manually updated if you want them to appear in a different language (or even if you simply want to customize the default English text).
π How do I know which elements are controlled by labels?
Simply expand the Labels section in the right sidebar of the game editing page. All elements listed there are the ones that require manual updates. Whatever you see there is what you're responsible for translating or customizing manually.
π What happens if I set my game to any language other than English but don't update the labels?
The default label values are in English. If your game is set to another language from the portal but the labels aren't updated, those elements will still appear in English β even if the rest of the game content is in the correct language. This creates a visible inconsistency for your users, as shown in the visual guide above.
π Which specific labels can I edit right now?
All 7 pre-filled labels are described in detail in the visual guide above: welcome, instructions, timeUp, successTitle, successDescription, buttonLabel, and disclaimer.
Additionally, leadTitle and leadDescription can also be edited manually β these are not pre-filled for now but will be in the future. See the section above for details on how to add them
π What gets translated automatically, without me needing to touch labels?
The lead form fields (e.g., Full Name, Email) and the text of the continue button (displayed in some templates) β are translated automatically based on the Language property set for the game. You don't need to manually set these β they should reflect the selected language out of the box.