# 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. - Source: https://docs.ghlcustomercare.com/docs/documents-and-contracts/documents-and-contracts-2/documents-contracts-templates-with-opportunity-custom-values-155000008460 - Section: Documents & Contracts / Documents and Contracts - Reading time: 4 min - Images: 7, each explained below --- 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?](#what-are-opportunity-custom-values-in-documents-and-contracts-templates) - [Key Benefits of Opportunity Custom Values](#key-benefits-of-opportunity-custom-values) -  [Before You Begin](#before-you-begin) -  [How To Set Up Opportunity Custom Values in a Template](#how-to-set-up-opportunity-custom-values-in-a-template) - [How To Use the Template in a Workflow](#how-to-use-the-template-in-a-workflow) - [Frequently Asked Questions](#frequently-asked-questions) - [Related Articles](#related-articles) --- # **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)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155078647993/original/ucokRQbsZNUCMCrEK6NdGK41ePWBpxqX6Q.png) **What Are Opportunity Custom Values in Documents & Contracts Templates? (image 1 of 7)** 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/. - How to confirm: Important: These instructions apply to reusable templates, not individual documents. Go to Payments → Documents & Contracts → Templates and confirm that the Templates tab is selected. - Controls: Templates - Next: When 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)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155078647671/original/qcZg8-1VjKXiTbazub2Q7eTA50BJ51VIvQ.png) **What Are Opportunity Custom Values in Documents & Contracts Templates? (image 2 of 7)** 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. - What this covers: When editing a template, the browser address also contains /templates/. - Controls: Templates - Next: Opportunity 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)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155078647998/original/NlNTxn7V3MIBN7WP2B71zDnOU1zGEQD4kg.png) **How To Set Up Opportunity Custom Values in a Template (image 3 of 7)** 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. - Where to go: 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. - Controls: + New, +, Text, Table, Merge Fields, Save - Next: Select: Contact → Custom Fields → Opportunity Details → Field Name Full 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. 5. Select: **Contact → Custom Fields → Opportunity Details → Field Name** ![How To Set Up Opportunity Custom Values in a Template (image 4 of 7)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155078647578/original/BSMYpKnRcoGJX0FIUVkEGeM84F6jaCX6Fw.png) **How To Set Up Opportunity Custom Values in a Template (image 4 of 7)** 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. - What to choose: Select: Contact → Custom Fields → Opportunity Details → Field Name - Controls: + New, +, Text, Table, Merge Fields, Save - Next: Confirm that the merge-field token appears in the correct location. Click Save. Full 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. 6. Confirm that the merge-field token appears in the correct location. 7. Click **Save**. ![How To Set Up Opportunity Custom Values in a Template (image 5 of 7)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155078647569/original/MqJGtC5dR-z4i7miIuErmapxWI_2hQ4OhA.png) **How To Set Up Opportunity Custom Values in a Template (image 5 of 7)** 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. - How to confirm: Confirm that the merge-field token appears in the correct location. Click Save. - Controls: + New, +, Text, Table, Merge Fields, Save - Next: 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. Full 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`](http://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)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155078647697/original/nOEtTsfMyPCT_InLa9A8nT-WYw72lX0v5w.png) **How To Use the Template in a Workflow (image 6 of 7)** 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. - What this covers: You only need both triggers when either event should start the workflow. - Fields: Configure the action: - Controls: Automation → Workflows, + Add Action, Send Documents & Contracts, From User, Create as Draft, Send Directly, Save Action - Next: Configure the trigger filters, such as the pipeline, stage, or status. Full procedure: 1. Go to Automation → Workflows. 2. Create a workflow or open an existing one. 3. Add the trigger that matches your process: 4. Configure the trigger filters, such as the pipeline, stage, or status. ![How To Use the Template in a Workflow (image 7 of 7)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155078647558/original/HvrPOe_pxZztzWDhVUrYYuyRz2v4FXnCNg.png) **How To Use the Template in a Workflow (image 7 of 7)** 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. - What this covers: Configure the trigger filters, such as the pipeline, stage, or status. - Fields: Configure the action: - Controls: Automation → Workflows, + Add Action, Send Documents & Contracts, From User, Create as Draft, Send Directly, Save Action - Next: Click + Add Action and select Send Documents & Contracts. Configure the action: Click Save Action, then publish the workflow. Full procedure: 1. Go to Automation → Workflows. 2. Create a workflow or open an existing one. 3. Add the trigger that matches your process: 5. Click **\+ Add Action** and select **Send Documents & Contracts**. 6. 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. 7. 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. --- ### **Related Articles** - [](https://docs.ghlcustomercare.com/docs/opportunities-and-pipelines/getting-started-with-opportunities/how-to-use-custom-fields-for-opportunities)[How to Use Custom Fields for Opportunities](https://docs.ghlcustomercare.com/docs/opportunities-and-pipelines/getting-started-with-opportunities/how-to-use-custom-fields-for-opportunities) ⁠ - [](https://docs.ghlcustomercare.com/docs/documents-and-contracts/documents-and-contracts-2/how-to-create-and-send-document-or-contract-templates-automatically-in-a-workflo)[How to Create and Send Document or Contract Templates Automatically in a Workflow](https://docs.ghlcustomercare.com/docs/documents-and-contracts/documents-and-contracts-2/how-to-create-and-send-document-or-contract-templates-automatically-in-a-workflo) ⁠ - [](https://docs.ghlcustomercare.com/docs/workflows/documents-and-contracts-3/workflow-action-send-documents-contracts)[Workflow Action — Send Documents & Contracts](https://docs.ghlcustomercare.com/docs/workflows/documents-and-contracts-3/workflow-action-send-documents-contracts) ⁠ - [](https://docs.ghlcustomercare.com/docs/documents-and-contracts/documents-and-contracts-2/multiple-recipient-support-on-documents-contracts)[Multiple Recipient Support on Documents & Contracts](https://docs.ghlcustomercare.com/docs/documents-and-contracts/documents-and-contracts-2/multiple-recipient-support-on-documents-contracts)⁠ --- Documentation for GHL Customer Care. Support: support@ghlcustomercare.com