Skip to main content

Translations and valuesets

The Translations and Valuesets tabs manage the text content and predefined value lists used throughout the storefront. Use these settings to localize the UI and configure the options that appear in dropdowns and filters.

Translations​

Go to Propeller > Translations in your WordPress admin.

The plugin ships with default UI labels in English (and other supported languages). The Translations tab lets you override any label for any language.

What can be translated​

Translations cover all user-facing text rendered by the plugin:

  • Button labels (add to cart, proceed to checkout, place order)
  • Form labels and placeholders (name, address, email)
  • Navigation items (catalog, account, cart)
  • Status messages (order placed, quote submitted, item added)
  • Error messages (out of stock, invalid quantity, login required)
  • Section headings and descriptions

These are plugin UI labels, not product content. Product names, descriptions and attribute values come from Propeller and are managed through the API or Backoffice. For translating product data and other content on the page, use TranslatePress or the WordPress site language setting.

Managing translations​

Each translation has a key and a value per language. The Translations tab shows a list of all available keys with their current values. To change a label:

  1. Find the key in the list (use the search field to filter)
  2. Edit the value for the language you want to change
  3. Save the changes

Your overrides take effect immediately on the storefront.

Changing the site language​

To set the website language, go to WordPress Settings > General > Site Language. When you change the site language, the plugin fetches product and catalog data in that language from Propeller. You can override any plugin UI label for that language through the Translations tab.

Multi-language setups​

For sites that support multiple languages, use TranslatePress. TranslatePress is the recommended translation plugin. The free version supports up to two languages. Propeller has not tested with other translation plugins.

The Propeller plugin provides a language switcher shortcode that works with TranslatePress. Plugin UI label translations are managed through the Translations tab. TranslatePress handles the rest of the page content.

Valuesets​

Go to Propeller > Valuesets in your WordPress admin.

Valuesets in Propeller are predefined lists of allowed values used for product attributes, filters and dropdowns. For example, a "Color" attribute might use a valueset containing "Red", "Blue" and "Green". These values appear in product specifications and catalog filters.

How valueset localization works​

Valuesets in Propeller are localized, meaning each value can have translations for every language configured in your environment. When the plugin fetches product data through the GraphQL API, valueset values are returned in the requested language automatically.

What the Valuesets tab does​

The Valuesets tab fetches all valuesets from the Propeller API and adds them as translation entries in the plugin. This was originally built to work around a limitation in an earlier version of the API where localized valueset values were not reliably returned. The plugin would fetch the valueset values and store them locally as translations, ensuring they displayed correctly in the storefront regardless of API behavior.

Do you need this?​

This feature is under review and may be removed in a future version of the plugin. The v2 GraphQL API returns localized valueset values directly, which makes the local copy in the plugin unnecessary. The current recommendation is to leave the Valuesets tab as is.

Next steps​

  • Sitemaps — configure XML sitemap generation
  • Multi-site setup — run multiple storefronts from one WordPress installation