How to create a custom document from scratch

In this article, you'll learn how to build a custom document from a blank page. Every account comes with Invoice, Estimate, Work Order and Payment Receipt templates. A custom document is for anything else you send customers, like a service agreement, a waiver or a checklist they sign.

Note: Every CRM account has custom documents. You don't need to turn anything on in Features first.
Note: You design documents in the web CRM on a computer. On a phone, both the app and the web CRM show a note that says Designing happens on a desktop. From a phone you can add, preview, duplicate and delete documents, but you can't design them. The last section covers that.

To open your document templates:

  1. Click the Settings gear at the bottom of the menu.
  2. Under General, click Documents.
Tip: Don't see the gear? Your role needs the Account Settings permission. Ask your admin to turn it on under Settings, then Users & roles, then Roles & permissions.
The Document templates page, with the standard templates and any custom ones
The Document templates page, with the standard templates and any custom ones

Creating a new custom document

  1. On the Document templates page, click Add Custom Document.
  2. The CRM creates a document called New Document and opens it in the designer.
  3. The page starts out empty and says Empty template, start by dragging some layouts.
Tip: Want to start from something close? Open that document and click Duplicate at the top of the designer. The three-dot menu on the templates page has a Duplicate option too.

Naming your document

The Document name box sits at the top of the designer. Replace "New Document" with a name you'll recognize, like "Service Agreement". That's the name you'll see in your templates list.

Adding layouts

The panel on the right has three tabs: Design, Tools and Layout. It opens on Design.

A layout is one row on the page, split into one, two or three columns. There are five to pick from.

  1. Click the Layout tab.
  2. Drag a layout onto the page.
  3. For more rows, drag another layout below the last one. If you drop it on a row that's already there, a yellow Drop here bar shows and the new row goes in above it.

Hover over a row to see its controls. The trash icon deletes the row. To move a row, drag its move icon to a new spot.

Warning: The Design tab has ready-made page designs like Basic, Minimal and Blue, but picking one replaces everything on your page. The CRM asks you to confirm first.
Opening a template and switching between the Design, Tools and Layout tabs

Adding content with tools

An empty column says Drag Something Here. That's where tools go, and each column holds one tool.

  1. Click the Tools tab.
  2. Drag a tool into an empty column. When you're over the right spot, the column changes to Drop Here.

Here's what each tool does:

  • TEXT: a block of text you type and format.
  • ITEMS LIST: the job's line items and their prices. Click its brush icon to change the style to Minimal, Stripes, With borders or Dark Titles.
  • TABLE: a simple table you can type into.
  • LOGO: your company logo. If your logo isn't on file yet, the block says so, and the logo shows up once it is.
  • DIVIDER: a line that separates sections.
  • IMAGE: click Choose Image to upload a picture from your computer. To swap it later, click the picture.
  • SIGNATURE: a box for your customer to sign, with a caption you can edit. When a document has one, the templates page shows Required in its Signature column.

To remove a tool, hover over it and click its trash icon. On text, logo and image blocks, the brush icon changes the block's background color.

Editing text and inserting values

Click into a text, table, logo or signature block and a toolbar pops up. It has bold, italics, underline, font, size, Line Height, alignment, text and background colors, undo and redo, and a table button.

To pull in details the CRM already has, like the customer's name or the job address:

  1. Click where you want the detail to go.
  2. In the toolbar, click Insert values.
  3. Pick a group, like Client values, Job/invoice values or Account values, then pick the value.

While you're designing, each value shows in curly brackets. When you send the document from a job, the CRM swaps in that job's real details, so your customer never sees the brackets.

Tip: Want a heading, a quote or a list? Click Insert Markdown in the same toolbar. Pick Normal, Heading 1, Heading 2, Heading 3 or Quote, add bold, italics, bullet lists, numbered lists or a link, then click Insert.
Clicking into a text block and opening the Insert values menu

Choosing what your customer sees

  1. Click Settings at the top of the designer to open Document settings.
  2. Subject is the email subject when you send the document by email.
  3. Message is the text that goes with the document, whether you send it by email or by text.
  4. Under What can my client see?, check or uncheck Quantity, Price, Line total, Service items and Product items.
  5. Click Save in the panel. That saves the whole document too.
Opening Document settings from the top of the designer

Previewing and saving

  1. Click Preview to see the finished page filled in with sample details. Click the × to close it.
  2. When you're happy with it, click Save. You'll see Saved next to the buttons.
  3. Click Back to return to your document templates. Your new document shows in the list with (Custom) after its name.
Warning: Save before you leave. If you close the tab or leave the page with unsaved changes, your browser warns you first.
Note: To remove a custom document, click Delete template at the top of the designer, or click Delete in the three-dot menu on the templates page. Either way, the CRM asks you to confirm. You can't delete the four standard templates.

Adding a document from your phone

You can start a custom document on your phone and design it later on a computer. This works the same in the phone app and in the web CRM on a phone.

  1. Open the menu and tap the Settings gear at the bottom.
  2. Under General, tap Documents.
  3. Tap + Add Custom Document.
  4. Type a name in the Name box (it starts out as "New Document"), then tap Create.

The new document shows in the list with (Custom) after its name. Every row has Preview, which opens a PDF filled with sample details, and Duplicate. Custom documents also have Delete, which asks you to confirm. When you're ready to design the page, open Settings, then Documents in the web CRM on a computer. In the phone app, the General group also has a Document designer (web) row that opens the web CRM in your phone's browser, but you still need a computer to design.