Module Assessment | Yext Hitchhikers Platform
Background
The Turtlehead Tacos team has finished building out their website in English, and now they want to add a Spanish version. They want to begin by making sure their Restaurant and FAQ entity types have translated content.
In order for the Spanish site experience to be effective, the same fields on FAQ and Restaurant entities need to be searchable in both English and Spanish. To make this happen, you will:
- Enable the Multi-Language Profiles feature in the Yext account
- Update the alternate language field behavior for some custom fields
- Add translations where needed on field options and field names
- Upload a spreadsheet of Spanish FAQ entities
Your Challenge
Navigate to Account Settings > Account Features and turn on the Multi-Language Profiles feature.
First, set the multi-language behavior for two fields: Active on Answers (an internal field that determines whether an entity profile is part of a Search experience) and Primary CTA (a custom field that appears on many different entity types). Navigate to Knowledge Graph > Configuration and click the Fields tile. Find each field below and click to edit the field settings. Under the Advanced section, set the Alternate Language Field Behavior as follows:
- Active on Answers: This field should have a consistent value for all language profiles of an entity by default, but you want the team to be able to edit this for specific language profiles if they choose to. To do this, set the behavior to Overridable.
- Primary CTA: Since this is a text string, the value needs to be different for each language profile on an entity. To do this, set the behavior to Language-Specific.
Next, add translated field names for fields that will appear in your Spanish search experience. Find each field and click to edit the field settings. Under the Field Name, click Add Translation and select Spanish from the dropdown menu (don’t choose any of the Spanish language variations, e.g., “Spanish (Spain)”). Enter the translations for each field name below:
- Restaurant Features: Características del restaurante
- Restaurant Type: Tipo de restaurante
- Promoting Events: Promoción de eventos
You need to add translated content for some custom option-select fields. For each field below, click to edit the Field Settings (in the Settings section, below the Field Name, ID, and Entity Type Availability). Under the Translations option, click Add Translation and add the following translated options for each field:
Restaurant Features:
- Outdoor Seating - Asientos al abierto
- Live Music - Música del vivo
- Accepting Reservations - Acepta reservas
- Dog Friendly - Permite mascotas
- Breakfast for Dinner - Desayuno para la cena
- Sells Merchandise - Vende Mercancías
Restaurant Type
- Food Truck - Camión de comida
- Dine-in Restaurant - Restaurante para cenar
Now that you’ve finished up the configuration, you can start adding Spanish language profiles to your entities! You need to add Spanish (
es
) profiles for all Restaurant and FAQ entities. In the Knowledge Graph, filter for all Restaurant entities. Select all entities in the filter (not just the first 25 on the page!), and choose Edit from the More Actions dropdown.In the bulk edit view, find the Languages module on the right. Click Add Language and select Spanish (this should have a language code of
es
— again, make sure not to choose one of the Spanish language variations). Click Add.Repeat the last two steps for your FAQ entities — select all FAQ entities, bulk edit, and add the Spanish (
es
) language profile.First, manually update one of your FAQ entity profiles to check your configuration before uploading the whole spreadsheet. Find the FAQ entity with the ID faq-1 (hint: the question is “Do you sell gift cards?”). Click to edit the entity.
In the Languages module, choose the Spanish entity profile. Edit the following fields:
- Question: “¿Se venden tarjetas de regalo?”
- Answer: “¡Seguro! Además, por tiempo limitado, ¡te ofrecemos un bonus de $5 en todas las compras realizadas con tarjetas de regalo!”
- Primary CTA > Label: “Compra ahora”
- Primary CTA > Link: “www.turtleheadtacos.com/giftcard”
- Keyword: “Tarjeta de regalo”
Now you’re ready to upload the rest of the Spanish FAQs! Download the Spanish FAQs file. Note that Column B contains a “Profile Language” field with “es” (the language code) as the value. This will update the only the “es” profile for the entity IDs specified in Column A. Need a refresher on how to upload entities? Check out the Entity Upload unit.