Skip to main content
All CollectionsCRM and salesDocument generator
Creating and uploading a new document template
Creating and uploading a new document template

In this article, we will tell how to correctly create your own document template and how to add it to your Workspace for work in CRM

Uspacy Support Team avatar
Written by Uspacy Support Team
Updated over 5 months ago

To work with documents in CRM and easily generate them, you need to have your own templates in the system.

But first they need to be created and uploaded to Space.

🌟Only the administrator or superadministrator of Space can do this.

About everything below ⬇️

How to create your own template?

On your personal computer, use a program for working with text files. It can be MS Word, LibreOffice, etc.

And create the type of document you need.

💡We have added a template to the system that you can download and, on the basis of its design, create your own. You can find this example template in the upload window.

It can be an invoice, a sales contract or other documents. For our article we chose a document confirming the shipment of goods.

In the process of forming a template in the text, highlight the information that should be pulled from the system. That is, some places in the document must contain the data that is in the fields of the entity element card.

❗️Templates are created for each entity. That is, separately for deals, leads, contacts or companies.

Once you've created the desired template text and determined the data to be pulled into the document from the element card fields, you need to replace it with a character code. This will ensure a successful generation process.

Where to find the character code?

A special code is generated for each field of each entity in the system. You can find it by going to Section settings and opening the Fields for document templates block in the Documents tab.

There you will see a list of the names of all fields in CRM and the character codes that correspond to them.

For convenience, you can filter the fields according to the entity for which they are characteristic.

Both standard fields in CRM and custom fields have their own character codes. So, you can pull any information you need, which is contained in the card of the entity element into the generated document.

🔍 You can read more on how to work with custom fields in the following article.

So, select the desired field and copy its character code.

And paste in the desired place of your template.

Similar actions must be taken with each field, the data from which must be pulled into the generated document.

💡Please note that character codes are related to an entity. What does it mean?

For example, you create a template and plan to use it in deals. But in addition to the character codes of the fields, which are specific to deals, you can also add from contacts. When generating the document from the deal card, the data from the contact fields will not be pulled. Even if the correct character codes are inserted there.

Therefore, this should be taken into account when creating a template. The simplest option is when the file uses the character codes for only one entity plus the character codes related to the document (${DocumentName}, ${DocumentId}, ${DocumentDate}, ${DocumentNumber}).

💡If you want the generated document to include products (their characteristics, such as name, price, discounts, etc.) that are attached to the deal, then you need to add the corresponding symbol codes to the template.

❗️Please note, if you do not see the fields that characterize the products in the list, and you cannot search for them, then first "activate" the products in the card of any deal. That is, just go to this tab.

For example, in the template it can be used in the form of a table. It is enough to create the first row - a header. Write the characteristics of the product (goods/services) in it. And one more row with columns for codes of the fields that correspond to them.

If several goods are attached to the deal, all of them will be automatically added to the generated document.

In order for the values to be added correctly, please note that only the character codes of the fields that characterize each product can be placed in the rows of the table. They are:

${ProductsIndex}

${ProductsPreviewImage}

${ProductsProductName}

${ProductsProductQuantity}

${ProductsProductMeasureName}

${ProductsProductPriceRaw}

${ProductsProductDiscountRate}

${ProductsProductDiscountSum}

${ProductsProductTaxRate}

${ProductsProductTaxAmount}

${ProductsProductTaxIncluded}

${ProductsProductPriceRawSum}

Other fields for products and their symbol codes apply to ALL products included in the deal. Therefore, for the correct display of information, they should be placed outside the rows characterizing a separate product.

Such fields are the following:

${TotalRaw}

${TotalDiscountAmount}

${TaxesTaxValue}

${TotalAmountBeforeTax}

${TotalSum}

${TotalProductsCount}

☝🏻 You can find and download an example of invoice template here.


💡If it is necessary that the price of the products, their total amount or the amount of the deal, etc. (that is, any field of the type Money) should be entered in the form of the text, then the part ~words should be added to the character code.

Let’s consider the example of the Deal amount field. To display the deal amount by using the text form in the document, you need to enter the character code in the template as follows:

Deal Amount:

${DealsAmountOfTheDeal~words}

If you need both a numerical and text form, then you can enter it like this:

Deal Amount:

${DealsAmountOfTheDeal}

(${DealsAmountOfTheDeal~words})

So, when everything is ready, just save your template in *.docx format and go to the next step.

How to upload a template to Space?

This can be done in several ways. The first one is on the Section settings page, in the Documents tab, in the Document templates block. You just need to click on the New template button.

The second is in the element card of the entity you need. In the Documents tab, click on the New template button.

🌟You can work with the document generator and download your own templates using all plans. The only difference is their number.

  • The Free plan provides 1 template.

  • Standard - 5.

  • Professional - unlimited.

Regardless of the way you select, an upload form will open. Use the Select file button to add the template to the system.

💡Check again that your template matches the required *.docx format.

After that, the file will be uploaded to the system. It will open and you can set the starting parameters for the template.

Therefore, first decide on the title, it will be automatically pulled from the file. But, of course, it can be changed. And also decide on the activity. If you want the template to be used in CRM, then the check mark.

Next, select for which entity(ies) the template will be available.

☝🏻Please note that deals can be configured to use the template only in the desired funnels.

If you upload a template from an element card, the Binding to CRM sections parameter will automatically be filled with the value of the entity you are working with. In the case it is a deal, then the funnel is also pulled into. Or a direction, if it is a smart object and for which this possibility is provided by the settings.

But, of course, these automatic parameters can be changed and additionally specify the required entities. Or directions if we are talking about deals. Or directions if they are active for created smart objects.

And finally, specify which of the Space users will have access to work with the template. You can select all employees at once, or mark only the ones you need.

You can configure the Numerator for the template a little later. Follow our updates 😉

When everything is ready, just click Save.

The template will then appear in the list.

And it will also be available for selection in the cards of elements, those entities to which it is related.

The template can now be used to create documents on its basis.

🔍 You can read more about how to generate a document in CRM in the following article.

If you have additional questions or you need to contact the support, send a request to this email [email protected]

Invoice template

Attachment icon
Did this answer your question?