---
title: "SIGN BUTLER V2 – Setup, Register & config steps"
description: "Learn how to setup SIGN Butler, configure the permission sets and register. To register, make sure to have your PDF Butler username and Admin password. Class: cadmus_sign2.Actionable_SignButlerSilent [Download documentation here](https://assets.pdfbutler.com/website/academy.folders/Configuration%20Sign%20Butler%20V2.pdf) Or watch the setup here: [https://www.youtube.com/watch?v=O-YAwK8Cz3E](https://www.youtube.com/watch?v=O-YAwK8Cz3E)[https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000G0oZxUAJ](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000G0oZxUAJ) #### Introduction This guide…"
url: "https://pdfbutler.com/academy/sign-butler-academy/sign-butler-v2/sign-butler-v2-setup-register-config-steps/"
updated: "2026-06-02"
category: SIGN BUTLER V2
---

# SIGN BUTLER V2 – Setup, Register & config steps

Learn how to setup SIGN Butler, configure the permission sets and register. To register, make sure to have your PDF Butler username and Admin password.

Class: cadmus_sign2.Actionable_SignButlerSilent

[Download documentation here](https://assets.pdfbutler.com/website/academy.folders/Configuration%20Sign%20Butler%20V2.pdf)

Or watch the setup here:

[https://www.youtube.com/watch?v=O-YAwK8Cz3E](https://www.youtube.com/watch?v=O-YAwK8Cz3E)[https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000G0oZxUAJ](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000G0oZxUAJ)

#### Introduction

This guide walks through the complete installation and configuration process for Sign Butler in Salesforce. By following these steps, you will be able to:

- Install Sign Butler
- Configure permissions
- Register your Sign Butler environment
- Create signer data sources
- Configure sign request templates
- Set up document signing
- Send documents for signature directly from Salesforce
- Signing the document

This setup example uses an Opportunity-based signing process, but the same approach can be adapted for Quotes, Contracts, or custom Salesforce objects.

---

#### Prerequisites

Before installing Sign Butler, verify the following requirements:

##### 1. Verify PDF Butler Installation

Sign Butler requires PDF Butler to be installed and properly licensed.

Confirm that:

- PDF Butler is installed in Salesforce.
- The license is active and not expired.
   ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-15.20.29-300x76.jpg)

##### 2. Complete the PDF Butler Setup

Before continuing, complete the PDF Butler "[Create Your First Document](https://pdfbutler.com/academy/pdf-butler-academy/get-started/create-your-first-quote/)" setup guide.

After completing the setup, verify that a Quote Doc Config exists.

Navigate to: **PDF Butler → Doc Config**

You should see the Quote document configuration created during the PDF Butler setup process.

##### 3. Enable Lightning Email Templates

Sign Butler uses Salesforce Lightning Email Templates for all email communications.

To enable them:

1. Open Salesforce Setup.
2. Search for **Lightning Email Templates**.
3. Enable the feature if it is not already active.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-15.21.31-300x62.png)

Once enabled, Sign Butler can send emails using Salesforce's email framework.

---

#### Installing Sign Butler

 

##### Step 1 – Access the Sign Butler Academy

Navigate to the Sign Butler Academy and locate the [installation guide](https://pdfbutler.com/academy/sign-butler-academy/sign-butler-v2/sign-butler-v2-the-complete-guide/).
 From there, access the Salesforce AppExchange listing.

##### Step 2 – Install from AppExchange

On the AppExchange page:

1. Click **Get It Now**.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-15.22.18-300x86.jpg)
2. Log in with your Salesforce credentials.
3. Select the environment where Sign Butler should be installed:
   - Production
   - Sandbox

##### Step 3 – Confirm Installation

During installation:

1. Verify your information.
2. Accept the terms and conditions.
3. Choose whether to receive email communications.
4. Click **Confirm and Install**.

The installation process may take several minutes.
 Salesforce may display a message indicating that installation is still processing. If this occurs, wait for the completion email before proceeding.

---

#### Assigning Permission Sets

After installation completes, assign the appropriate Permission Sets.

Navigate to: **Setup → Permission Sets**

##### Sign Butler Admin Permission Set

Assign to:

- Salesforce Administrators
- Users responsible for configuration

---

#### Registering Sign Butler

1. Open the Sign Butler App
2. Navigate to: **Sign Butler → Admin**
3. Enter PDF Butler Credentials
    Use the credentials received during PDF Butler registration.
    You will need:
    - PDF Butler Username
    - PDF Butler Admin Password
4. Click **Check Credentials**.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-16.14.44-300x115.png)
5. Authorize the connection.
6. Allow Sign Butler to connect to your Salesforce environment.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-16.15.05-293x300.png)

Once validated, registration is complete.
 ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-16.15.21-300x105.png)

---

#### Configure Salesforce Email Deliverability

Since Sign Butler sends emails through Salesforce, email deliverability must allow outgoing messages.

Navigate to: **Setup → Deliverability**

Set: **Access Level = All Email
 ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-16.15.56-300x134.png)**

Save the configuration.

This allows Sign Butler to send signing-related emails through Salesforce.

---

#### Link the Sign Request Object

The Sign Request object must be linked to the Salesforce object from which signing will begin.

In this example, signing starts from an Opportunity.

1. Navigate to: **Sign Request Object → Fields & Relationship**
2. Create a new field:
    Field Type: Lookup Relationship
    Related Object: Opportunity
    Field Label: Opportunity
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-16.18.42-300x121.png)

**Supporting Multiple Objects**

Signing can start from multiple objects, simply create additional lookup relationships.

Examples:

- Opportunity
- Quote
- Contract
- Custom Objects

---

#### Create the Primary Signer Data Source

Next, create a Data Source that identifies the signer.

1. Create a New Data Source
    Data Source Name: Primary Signer
    Type: Single Object
2. Build the SOQL Query
    Start from: **Opportunity Contact Role**Retrieve: Contact ID, First Name, Last Name, Email, Opportunity ID, IsPrimary, Contact Role, etc
3. Add Filters: **Opportunity ID = Record ID**

This ensures the query only retrieves contacts related to the current Opportunity.

---

#### Create a Sign Request Template

1. Navigate to: **Sign Butler → Sign Request Templates**
2. Create a new template.
    Template Name: `Quote Signing`
3. Object: Opportunity
4. Signer Data Source:`Primary Signer`
5. Master Object Field: `Name`
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-16.43.52-300x144.png)
6. Click Next
7. Add a Signer
8. Select the Signature Methods
9. Inform the Data Source
10. Populate ID, First Name, Last Name, Email and Language
     ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-16.48.36-300x123.png)
11. Click to Add
12. Click Next and Submit

---

#### Configure Email Templates

All Sign Butler emails use Salesforce Lightning Email Templates.

1. Navigate to: **Email Templates → Sign Butler Emails
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.03.45-300x100.png)**
2. Click the arrow to share![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.04.37-300x59.png)3. Share with users![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.06.03-300x262.png)

Without access to the email templates, users cannot send Sign Butler emails.

---

#### Create a PDF Butler Pack

1. Navigate to: **PDF Butler Packs**
2. Click New
3. Inform a Name
4. Check the Active checkbox
5. Select the Leading Doc Config
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.08.53-300x147.png)
6. Save it

---

#### Create the Sign Butler Actionable

1. Add a new Actionable to the Pack you just created
    Actionable Type: Sign Butler
    Example Name: `Sign Opportunity`
    Class: cadmus_sign2.Actionable_SignButlerSilent
    Activate: Ensure the Actionable is marked as Active.
    Sign Request Template
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.09.19-300x103.jpg)
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.12.37-300x259.png)

---

#### Add a Signature Placeholder

Before documents can be signed, a signature placeholder must exist in the template.

1. Go to your Doc Config
2. Open PDF Butler configuration
3. Make sure that you have a Signer Merge Field in your document
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.23.57-300x300.png)
4. Create a new Config Type.
    Type: SIGN_PLACEHOLDER
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.26.49-300x203.png)
5. Save it

---

#### Generate the Document

1. Add the PDF Butler Previewer component to the Opportunity page.
    Configure it to use the newly created Pack.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.28.49-300x68.jpg)
2. Open an Opportunity and generate the document.
    Click: **Sign Opportunity
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.29.48-300x239.jpg)**
3. Check the Opportunity's related lists.
    A new Sign Request record should be created.
4. Open the Sign Request to verify:
    Signer information
    Email delivery status
    Request details

If the email has been sent and no errors are displayed, the setup has been completed successfully.

---

#### Signing the Request

Once a Sign Request has been sent to you, follow these steps to review and sign the document:

 

1. Open the email containing the Sign Request.
2. Click **Sign Document** to access the document.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.36.13-300x129.png)
3. Review the document details and read through the content.
    ***Note:** To proceed with signing, you must review each page completely. Scroll to the bottom of every page, or use the **down-arrow navigation button** to automatically move through the document.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.37.57-300x158.jpg)*
4. Once you have reviewed the entire document, select the **"I have read the document"** checkbox.
5. Click **Sign Document**.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.39.05-300x91.png)
6. Choose your preferred signing method from the available options.
    ![](https://pdfbutler.com/wp-content/uploads/2023/08/Screenshot-2026-06-02-at-17.39.59-300x162.png)
7. Complete the signing process.

Once all required signers have completed their signatures:

1. A confirmation email will be sent to you.
2. Open the email and click the provided link to download the fully signed document.