Welcome to Portal

?Unknown\pull-down

Welcome to Zoho Cares

Bienvenido a Soporte de Zoho

Search our knowledge base, ask the community or submit a request.

Adding document fields automatically using text tags (field addition)

Zoho Sign helps users to add corresponding fields automatically to the document with text tags during the document signing process. This helps users send out the document for signature more quickly than manually adding the fields every single time. For example, if you have integrated Zoho Sign with Zoho CRM and would like to automatically add fields to a long and customized sales order with text tags, you can just add these fields directly into the document, thereby automating the entire digital signature collection process.

Popular use-cases:
  1. Integrating Zoho Sign with other applications like CRM, HRMS, Finance and much more
  2. Integrating Zoho Sign with in-house apps via API



What is a text tag?
  1. A text tag is a unique identifier that is associated with a field.
  2. You can add the respective text tag to add the corresponding field to the document.
  3. To add a signature field to your document, you can just type {{Signature}} or {{S}} instead of manually adding the signature field in Zoho Sign.
This will come in handy when you would like to automate your digital signature collection process. 

Zoho Sign offers text tags in two formats
  1. Longhand tags that are more descriptive
  2. Shorthand tags that are more brief
Shorthand tags are useful to avoid line breaks and formatting issues while using them in a long document.

Long form
Short form
Definition
{{Signature}} 
{{S}}
  A signature field added to the first recipient
{{Company:Recipient2}}
{{CO:R2}}
  A company field added to the second recipient
{{Textfield:Recipient1*}}
{{TF:R1*}}
  A mandatory text field added to first recipient
{{Jobtitle}}
{{JT}}
  A job title added to the first recipient
{{Initial}}
{{I}}
  An initial field added to the first recipient
{{Signdate}}
{{SD}}
  A date field added to the first recipient
{{Checkbox}}
{{[]}}
  A checkbox field added to the first recipient
{{Fullname}}
{{N}}
  A full name field added to the first recipient
{{Customdate:Recipient1}}
{{D:R1}}
  A custom date field added to the first recipient
{{Firstname}}
{{FN}}
A first name field is added to the first recipient
{{Lastname}}
{{LN}}
A last name field is added to the first recipient
{{Attachment}}
{{A}}
An attachment field is added to the first recipient.
{{Stamp}}
{{ST}}
A stamp field is added to the first recipient.
{{Email}}
{{E}}
An email field is added to the first recipient.

Tags for choice fields

Radio button
{{(Radio1):Recipient1:RadioA}}
{{(Radio2):Recipient1:RadioA}}
{{(Radio3):Recipient1:RadioA}}
{{(Radio4):Recipient1:RadioA}}
Radio button is assigned to Recipient 1. Radio A refers to the Radio button group and Radio 1, Radio 2 are the options. Radio buttons under the same group must be placed on the same page.
Dropdown
{{(DD:R1:Text(options="option 1, option 2, option 3")}}
Dropdown field with 3 options being assigned to recipient 1.

You can also edit font related options. To do so:

{{<field type>:recipient<n>:<field name in case of text field>*(font="<Font Name>":fontsize="<font_size>":fontcolor="<color_code>")}} 

For example: {{Textfield:Recipient1:Address*(font="Roboto";fontsize="24";fontcolor="ff0077")}}
Zoho Sign supports only those font types that are available in the font formatting list.

General format to automatic field addition: 
{{<field type>:Recipient<n>:<field name in case of text field>*}}

Notes
Note:
  1. If the recipient number is not mentioned in the document, it will be assigned to the first recipient by default. 
  2. You can mark a text fields and checkboxes as mandatory fields using "*".
  3. You can add text tags for documents less than 75 pages.
  4. You can also increase the width of the field by adding space in between the text tag and braces. Remember that the tags must be in a single line and the spacing must be added only at the end of the text tag and not at the beginning.
    For example: {{S:R1          }}  or  {{S:R1*                  }}
                           {{S                     }} or {{S*                }}
Info
You can find the examples of how these tags can be used in the document attached at the end of this help doc.

Sample document on how the automatic field addition needs to be added:



This is how the document will reflect the tags once uploaded for signature.



How it works:
  1. Add the required tags to the content of your document.
  2. Log in to Zoho Sign, then click the Send for signatures/Sign yourself button.
  3. Upload the document from your computer or any cloud storage service.
  4. Configure document settings, add recipients, and click the Continue button.
  5. Zoho Sign will automatically add fields where you have added text tags.
  6. You can edit the automatically-added fields and also add more fields, if required.
  7. Click Send.
  8. You can also save this document as a template for future use. 

Attachments :
Short hand tags examples.pdf14 KB
Helpful?151
Updated: 1 day ago
Share :
7 comments

What all tags are needed to set the prefill fields?

Hello,

For using the text tags as prefills, PFB response for the required use case.

You can use {{<field type>:Prefill or PF:<field label in case of Textfield and CustomDate>*}}

Sample Eg 1- {{Signature:Prefill*}}
Sample Eg 2- {{TF:PF:Address* }}

Regards
Shravan

Thanks for the reply @Shravan.

Hi,

Is it possible to set a default value of a text tag?

This works if I upload the document via the UI "Send for signatures / Send for myself".
However, via the Create Document API, it seems to ignore these tags - is there a property in the API to get it to recognize the tags?

Hi Vivek,

Sorry for the delayed response. You can do this by sending recipient details along with the uploaded document in the create document API call.

Hi Caolan,

At present, we do not have an option to set default_value in text tags. However, if you are an API customer, you can achieve this indirectly. You can add a text tag and set the default value to it by passing it in JSON parameters.

Assume you have a textfield text tag in the document = {{Textfield:Recipient1:Address*}}

You can pass the default_value inside JSON like below:

{
    "requests": {
        "request_name": "Test document",
        "default_fields": {
            "Address": "DEFAULT_ADDRESS_VALUE"
        }
    }
}