---
title: Picklist translations DataSource
description: "PDF Butler allows you to automatically use the translated value of a Salesforce picklist in your generated documents. Instead of displaying the API or default picklist value, PDF Butler retrieves the translation configured in **Salesforce Translation Workbench** based on the…"
url: "https://pdfbutler.com/academy/pdf-butler-academy/pdf-butler-by-datasource/picklist-translations-datasource/"
updated: "2026-08-10"
category: PDF BUTLER BY DATASOURCE
---

# Picklist translations DataSource

PDF Butler allows you to automatically use the translated value of a Salesforce picklist in your generated documents.

Instead of displaying the API or default picklist value, PDF Butler retrieves the translation configured in **Salesforce Translation Workbench** based on the language of the user or recipient.

This is especially useful when generating documents for customers in different languages without creating separate templates.

To understand the complete process, **read this article** or **watch the accompanying video tutorial** before configuring Picklist Translations. The video demonstrates each step visually and complements the instructions below.

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

---

#### Prerequisites

Before configuring Picklist Translations, ensure that:

- Salesforce **Translation Workbench** is enabled.
- Translations have been created for the desired picklist values.
- The field you want to translate is a Salesforce Picklist.

---

#### Configure Salesforce Translation Workbench

1. Navigate to **Setup**.
2. Look for **Translation Workbench**in the global search.
3. Click the **Translate** option.
4. Locate the object and picklist field you want to translate.
    *For this example object will be Opportunity and Field will be Stage.*
5. Create translations for the languages you want to support.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-08-10-at-11.07.26-300x146.png)

> **Note:**
> PDF Butler uses the translations configured in Salesforce. If no translation exists for a value, the original picklist value is returned.

---

#### Setting Up a Picklist Translation

 

##### Create a Picklist Translation Data Source

1. Open **PDF Butler** and navigate to **Data Sources**.
2. Create a new Data Source.
3. Select the Data Source type: **Picklist Translation**
4. Give it a descriptive name.
    *Example: Opportunity Stage Translation*
5. Select the Salesforce object (it can be any object).
    *Example: Opportunity*
6. Select the picklist field to translate (**API Name**).
    *Example: StageName*
7. Save the Data Source.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-08-10-at-11.33.48-300x192.png)

##### Configure the Doc Config

1. Open your Doc Config.
2. Load the Picklist Translation Data Source.
3. We need a field so you can create a dummy.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-08-10-at-11.40.26-300x188.png)
4. Create a new Config Type for the translated value.
5. Select the "Translate" checkbox.
6. Choose the Picklist translation DataSource.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-08-10-at-11.43.43-300x250.png)
7. Save the Doc Config.

##### Generate the Document

1. Open an Opportunity.
2. Generate the document.

PDF Butler will:

1. Retrieve the Opportunity.
2. Read the Stage picklist value.
3. Look up the translated label in Salesforce Translation Workbench.
4. Insert the translated value into the document.

![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-08-10-at-11.46.34-300x198.png)