---
title: Picklist translations DataSource
description: "[DataSource Demo - TRANSLATION PICKLIST](https://www.youtube.com/embed/Zd0XGDjW-y8?si=6RVoL-mY49sQ9HLv) PDF Butler can retrieve **translated picklist values** directly from **Salesforce Translation Workbench**. This allows the same document configuration to display a picklist value in the appropriate language instead of creating separate values or configurations for…"
url: "https://pdfbutler.com/academy/pdf-butler-academy/multi-language-multi-locale-multi-currency-multi-template-or-multi-branding/picklist-translations-datasource-2/"
updated: "2026-10-30"
category: "Multi-language, multi-locale, multi-currency, multi-template or multi-branding"
---

# Picklist translations DataSource

[DataSource Demo - TRANSLATION PICKLIST](https://www.youtube.com/embed/Zd0XGDjW-y8?si=6RVoL-mY49sQ9HLv)

PDF Butler can retrieve **translated picklist values** directly from **Salesforce Translation Workbench**. This allows the same document configuration to display a picklist value in the appropriate language instead of creating separate values or configurations for each language. 

In this example, the Opportunity Stage picklist is generated first in German and then in Dutch to show how the displayed value changes based on the language used for the document.

### Step 01: Verify the Picklist Translations

1. In **Salesforce Setup**, open**Translation Workbench**.
2. Select the **Language**, set **Setup Component** to **Picklist Value**, and select the **Object**that contains the picklist you want to translate. Confirm that translations are available for the required picklist values.

![](https://vthchkulqh-staging.wpdns.site/wp-content/uploads/2023/08/01_step01_salesforce_translation_workbench_stage.webp)

**In this example, translations are configured for the Stage picklist on the Opportunity object.**

### Step 02: Create the Picklist Translation DataSource

Before PDF Butler can use the translated picklist value, you need to add a DataSource that tells the configuration where to retrieve the translation.

1. In the PDF Butler, click **Data Source**, then select **New Data Source** from the dropdown.

![](https://vthchkulqh-staging.wpdns.site/wp-content/uploads/2023/08/02_step02_new_data_source_dropdown.webp)

1. In the popup window, select **Picklist Translation**, then click **Next**.
2. Enter a **Data Source Name** for the translation DataSource.
3. In **Translation Object**, enter the Salesforce object that contains the picklist.
4. In **Translation Picklist**, enter the picklist field you want to translate.

**Note:** The translation object can be a standard or custom Salesforce object, as long as the picklist is configured in Translation Workbench.

![](https://vthchkulqh-staging.wpdns.site/wp-content/uploads/2023/08/03_step02_configure_translation_object_and_picklist.webp)

**In this example, Opportunity is used as the Translation Object and Stage as the Translation Picklist.**

1. Click **Save**.

### Step 03: Add the Translation DataSource to the Doc Config

1. In the PDF Butler Doc Config, click **Add DataSource** on the left-hand side. Select the **Picklist Translation DataSource** you created.

![](https://vthchkulqh-staging.wpdns.site/wp-content/uploads/2023/08/04_step03_add_datasource_to_doc_config.webp)

1. Click **Add Field** and add a dummy field to the Picklist Translation DataSource. The dummy field is used by the translation configuration and does not need to appear in the document.

![](https://vthchkulqh-staging.wpdns.site/wp-content/uploads/2023/08/05_step03_add_dummy_field_to_datasource.webp)

### Step 04: Configure the Picklist Field for Translation

1. Open the Word document where you want the translated picklist value to appear. Locate the merge field for that value, or add one if it is not already present. You will use this merge field when creating the config type for the translated picklist value.

![](https://vthchkulqh-staging.wpdns.site/wp-content/uploads/2023/08/06_step04_word_document_picklist_merge_field.webp)

1. Back in PDF Butler, click **Add Config Type** on the left-hand side.
2. Select the relevant merge field name and leave the configuration type set to **Single**.

![](https://vthchkulqh-staging.wpdns.site/wp-content/uploads/2023/08/07_step04_add_config_type_single.webp)

1. In**Datasource**, select the data source that contains the original picklist value.
2. In **DataSourceField**, select the specific picklist field you want to translate.
3. In **MergeField**, enter the corresponding merge field from the Word document.

**Note:**If the required field is not available, add it to the DataSource and refresh the configuration before continuing.

![](https://vthchkulqh-staging.wpdns.site/wp-content/uploads/2023/08/08_step04_note_add_field_to_datasource.webp)

1. Enable the **Translate** option and select the **Picklist Translation DataSource** created earlier. This tells PDF Butler to use the translated text from Salesforce Translation Workbench instead of the original picklist value. Click **OK**.

![](https://vthchkulqh-staging.wpdns.site/wp-content/uploads/2023/08/09_step04_enable_translate_option.webp)

### Step 05: Save and Test the Translation

1. Click **Save to Server**and confirm that the configuration validates successfully.
2. Generate the document and verify that the picklist value appears in the expected language.

![](https://vthchkulqh-staging.wpdns.site/wp-content/uploads/2023/08/10_step05_verify_translated_picklist_preview.webp)