Skip to content
Documents & Contracts

Documents & Contracts Templates with Opportunity Custom Values

Learn how to add Opportunity custom values to Documents & Contracts templates and automatically populate accurate deal data through GHL Customer Care workflows.

4 min read957 words7 explained images
View as markdownOpen in ClaudeOpen in ChatGPT
Each image has a one line explanation. Switch to full detail for the step it belongs to, the fields and buttons involved, examples and the whole procedure.
On this page
  1. Key Benefits of Opportunity Custom Values
  2. Before You Begin
  3. How To Set Up Opportunity Custom Values in a Template
  4. How To Use the Template in a Workflow
  5. Frequently Asked Questions
  6. Related Articles

Opportunity custom values let you personalize Documents & Contracts templates with deal-specific information, such as a project budget, service type, or closing date. When a workflow generates the document, the platform replaces each merge field with information from the relevant Opportunity. This reduces manual editing and keeps documents accurate and consistent.

TABLE OF CONTENTS

What Are Opportunity Custom Values in Documents & Contracts Templates?

Opportunity custom fields store information about a specific deal. A merge field acts as a placeholder inside the template and displays the Opportunity’s saved value when the workflow generates the document. Unlike Contact fields, Opportunity values can differ for each deal associated with the same contact.

Important: These instructions apply to reusable templates, not individual documents. Go to Payments → Documents & Contracts → Templates and confirm that the Templates tab is selected.

What Are Opportunity Custom Values in Documents & Contracts Templates? (image 1 of 7) What this shows Important: These instructions apply to reusable templates, not individual documents. What this shows Illustrates the "What Are Opportunity Custom Values in Documents & Contracts Templates?" section of "Documents & Contracts Templates with Opportunity Custom Values". This screenshot appears in the "What Are Opportunity Custom Values in Documents & Contracts Templates?" section of "Documents & Contracts Templates with Opportunity Custom Values". The text alongside this image reads: Important: These instructions apply to reusable templates, not individual documents. Go to Payments → Documents & Contracts → Templates and confirm that the Templates tab is selected. Immediately after, the guide continues: When editing a template, the browser address also contains /templates/. Image 1 of 7 How to confirmImportant: These instructions apply to reusable templates, not individual documents. Go to Payments → Documents & Contracts → Templates and confirm that the Templates tab is selected.
Buttons and menus referenced Templates
Next stepWhen editing a template, the browser address also contains /templates/.

When editing a template, the browser address also contains /templates/.

What Are Opportunity Custom Values in Documents & Contracts Templates? (image 2 of 7) What this shows When editing a template, the browser address also contains /templates/. What this shows Illustrates the "What Are Opportunity Custom Values in Documents & Contracts Templates?" section of "Documents & Contracts Templates with Opportunity Custom Values". This screenshot appears in the "What Are Opportunity Custom Values in Documents & Contracts Templates?" section of "Documents & Contracts Templates with Opportunity Custom Values". The text alongside this image reads: When editing a template, the browser address also contains /templates/. Immediately after, the guide continues: Opportunity merge fields allow one reusable template to automatically adapt to different deals. Image 2 of 7 What this coversWhen editing a template, the browser address also contains /templates/.
Buttons and menus referenced Templates
Next stepOpportunity merge fields allow one reusable template to automatically adapt to different deals.

Key Benefits of Opportunity Custom Values

Opportunity merge fields allow one reusable template to automatically adapt to different deals.

  • Faster document creation: Reduce manual editing before sending proposals or contracts.
  • Accurate deal information: Pull values directly from the Opportunity record.
  • Reusable automation: Use the same template across multiple Opportunities and pipelines.
  • Consistent documents: Keep formatting and deal information standardized across your team.

 Before You Begin

Opportunity values can only populate when the required field, value, template, and workflow context are available.

Confirm the following:

  • The required field was created as an Opportunity custom field.
  • The Opportunity contains a value for that field.
  • The Opportunity is associated with the correct contact.
  • The template is saved before it is selected in a workflow.
  • The workflow uses an Opportunity-related trigger when deal information must populate.
  • The contact has a valid email address when the document will be sent.

Multi-role templates: Assign at least one fillable element to Contact before using the template in a workflow. Role details entered in the workflow override the corresponding template defaults.

 How To Set Up Opportunity Custom Values in a Template

Using the merge-field menu inserts the correct field token and helps prevent formatting or syntax errors.

  1. Go to Payments → Documents & Contracts → Templates.
  2. Click + New or open an existing template.
  3. Click the + icon and add a Text block or Table where the Opportunity information should appear.
  4. Place your cursor in the required location and click the Merge Fields icon.
How To Set Up Opportunity Custom Values in a Template (image 3 of 7) What this shows Go to Payments → Documents & Contracts → Templates. What this shows Illustrates the "How To Set Up Opportunity Custom Values in a Template" section of "Documents & Contracts Templates with Opportunity Custom Values". This screenshot appears in the "How To Set Up Opportunity Custom Values in a Template" section of "Documents & Contracts Templates with Opportunity Custom Values". The text alongside this image reads: Go to Payments → Documents & Contracts → Templates. Click + New or open an existing template. Click the + icon and add a Text block or Table where the Opportunity information should appear. Place your cursor in the required location and click the Merge Fields icon. Immediately after, the guide continues: Select: Contact → Custom Fields → Opportunity Details → Field Name. Image 3 of 7 Where to goGo to Payments → Documents & Contracts → Templates. Click + New or open an existing template. Click the + icon and add a Text block or Table where the Opportunity information should appear. Place your cursor in the required location and click the Merge Fields icon.
Buttons and menus referenced + New+TextTableMerge FieldsSave
Next stepSelect: Contact → Custom Fields → Opportunity Details → Field Name
All 4 steps in this procedure
  1. Go to Payments → Documents & Contracts → Templates.
  2. Click + New or open an existing template.
  3. Click the + icon and add a Text block or Table where the Opportunity information should appear.
  4. Place your cursor in the required location and click the Merge Fields icon.
  1. Select:

    Contact → Custom Fields → Opportunity Details → Field Name

How To Set Up Opportunity Custom Values in a Template (image 4 of 7) What this shows Select: Contact → Custom Fields → Opportunity Details → Field Name What this shows Illustrates the "How To Set Up Opportunity Custom Values in a Template" section of "Documents & Contracts Templates with Opportunity Custom Values". This screenshot appears in the "How To Set Up Opportunity Custom Values in a Template" section of "Documents & Contracts Templates with Opportunity Custom Values". The text alongside this image reads: Select: Contact → Custom Fields → Opportunity Details → Field Name. Immediately after, the guide continues: Confirm that the merge-field token appears in the correct location. Click Save. Image 4 of 7 What to chooseSelect: Contact → Custom Fields → Opportunity Details → Field Name
Buttons and menus referenced + New+TextTableMerge FieldsSave
Next stepConfirm that the merge-field token appears in the correct location. Click Save.
All 4 steps in this procedure
  1. Go to Payments → Documents & Contracts → Templates.
  2. Click + New or open an existing template.
  3. Click the + icon and add a Text block or Table where the Opportunity information should appear.
  4. Place your cursor in the required location and click the Merge Fields icon.
  1. Confirm that the merge-field token appears in the correct location.
  2. Click Save.
How To Set Up Opportunity Custom Values in a Template (image 5 of 7) What this shows Confirm that the merge-field token appears in the correct location. What this shows Illustrates the "How To Set Up Opportunity Custom Values in a Template" section of "Documents & Contracts Templates with Opportunity Custom Values". This screenshot appears in the "How To Set Up Opportunity Custom Values in a Template" section of "Documents & Contracts Templates with Opportunity Custom Values". The text alongside this image reads: Confirm that the merge-field token appears in the correct location. Click Save. Immediately after, the guide continues: Tip: Select fields from the Merge Fields menu instead of manually typing a generic token such as {{ opportunity.xyz }}. The menu inserts the exact token for the selected field. Image 5 of 7 How to confirmConfirm that the merge-field token appears in the correct location. Click Save.
Buttons and menus referenced + New+TextTableMerge FieldsSave
Next stepTip: Select fields from the Merge Fields menu instead of manually typing a generic token such as {{ opportunity.xyz }}. The menu inserts the exact token for the selected field.
All 4 steps in this procedure
  1. Go to Payments → Documents & Contracts → Templates.
  2. Click + New or open an existing template.
  3. Click the + icon and add a Text block or Table where the Opportunity information should appear.
  4. Place your cursor in the required location and click the Merge Fields icon.

Tip: Select fields from the Merge Fields menu instead of manually typing a generic token such as {{opportunity.xyz}}. The menu inserts the exact token for the selected field.

How To Use the Template in a Workflow

An Opportunity-related workflow trigger gives the platform the deal context needed to populate the template’s Opportunity merge fields.

  1. Go to Automation → Workflows.
  2. Create a workflow or open an existing one.
  3. Add the trigger that matches your process:
    • Pipeline Stage Changed: Starts the workflow when an Opportunity enters a selected stage.
    • Opportunity Status Changed: Starts the workflow when an Opportunity moves to a status such as Won or Lost.

You only need both triggers when either event should start the workflow.

How To Use the Template in a Workflow (image 6 of 7) What this shows You only need both triggers when either event should start the workflow. What this shows Illustrates the "How To Use the Template in a Workflow" section of "Documents & Contracts Templates with Opportunity Custom Values". This screenshot appears in the "How To Use the Template in a Workflow" section of "Documents & Contracts Templates with Opportunity Custom Values". The text alongside this image reads: You only need both triggers when either event should start the workflow. This part of the guide covers 1 field, listed below. Immediately after, the guide continues: Configure the trigger filters, such as the pipeline, stage, or status. Image 6 of 7 What this coversYou only need both triggers when either event should start the workflow.
Fields in this part of the guide Configure the action:
Buttons and menus referenced Automation → Workflows+ Add ActionSend Documents & ContractsFrom UserCreate as DraftSend DirectlySave Action
Next stepConfigure the trigger filters, such as the pipeline, stage, or status.
All 3 steps in this procedure
  1. Go to Automation → Workflows.
  2. Create a workflow or open an existing one.
  3. Add the trigger that matches your process:
  1. Configure the trigger filters, such as the pipeline, stage, or status.
How To Use the Template in a Workflow (image 7 of 7) What this shows Configure the trigger filters, such as the pipeline, stage, or status. What this shows Illustrates the "How To Use the Template in a Workflow" section of "Documents & Contracts Templates with Opportunity Custom Values". This screenshot appears in the "How To Use the Template in a Workflow" section of "Documents & Contracts Templates with Opportunity Custom Values". The text alongside this image reads: Configure the trigger filters, such as the pipeline, stage, or status. This part of the guide covers 1 field, listed below. Immediately after, the guide continues: Click + Add Action and select Send Documents & Contracts. Configure the action: Click Save Action, then publish the workflow. Image 7 of 7 What this coversConfigure the trigger filters, such as the pipeline, stage, or status.
Fields in this part of the guide Configure the action:
Buttons and menus referenced Automation → Workflows+ Add ActionSend Documents & ContractsFrom UserCreate as DraftSend DirectlySave Action
Next stepClick + Add Action and select Send Documents & Contracts. Configure the action: Click Save Action, then publish the workflow.
All 3 steps in this procedure
  1. Go to Automation → Workflows.
  2. Create a workflow or open an existing one.
  3. Add the trigger that matches your process:
  1. Click + Add Action and select Send Documents & Contracts.
  2. Configure the action:
    • Select the From User.
    • Select the saved template.
    • Choose Create as Draft or Send Directly.
    • Select the delivery channel.
    • Complete any required recipient or signer information.
  3. Click Save Action, then publish the workflow.

Use Create as Draft when testing. Open the generated draft and verify that every Opportunity field contains the expected value before changing the action to Send Directly. 

Frequently Asked Questions

Q: Why is an Opportunity value blank in the generated document?

Confirm that the field contains a value on the Opportunity that triggered the workflow. Also verify that you selected the field under Opportunity Details and saved the template before the workflow ran.

Q: Why is the merge-field token still visible?

The token normally remains visible while editing the template. It should be replaced when the workflow generates the document. If it remains in the generated document, reinsert the field using the Merge Fields menu and test again.

Q: Can I manually type an Opportunity merge field?

Yes, but the token must match the field’s exact merge key. Using the Merge Fields menu is recommended because it reduces typing and formatting errors.

Q: Which workflow trigger should I use?

Use Pipeline Stage Changed when the document should be created at a particular pipeline stage. Use Opportunity Status Changed when it should be created after a status change, such as when a deal is marked Won.

Q: Why does my template not appear in the workflow action?

Confirm that you created a template rather than an individual document and clicked Save. Only saved templates can be selected in the Send Documents & Contracts action.

Q: Why did the document remain in Drafts instead of sending?

Check whether the action uses Create as Draft. Also confirm that the contact has a valid email address, which is required even when SMS delivery is selected.

Was this guide helpful?

Related guides

How to use Documents & Contracts?6 min read · 15 imagesDocuments & Contracts: Email Templates and Team Notifications Setup8 min read · 17 imagesMultiple recipient support on Documents & Contracts3 min read · 5 imagesHow to Create and Send Document or Contract Templates Automatically in a Workflow6 min read · 11 images