> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/administration/settings/choose-and-customize-your-quote-document-template.md). # Choose and customize your quote document template The Quote templates section on Settings -> Quotes & Invoices -> Quotes controls how your quotes look to customers. Browse styles to pick one from the library and select **Use**; a live preview shows it with sample data. Use the preview tabs to check unsigned, signed, and scope-only examples. The tabs only change the example shown; they do not edit the template, pricing setting, or sample data and do not need to be saved. ## Keep one template or several Your business can keep a single quote template or add several named ones (for example "Standard" and "Service work"). Each template has a name so you can tell them apart: * **New template** adds another template; give it a name and then pick its style or customize it. * Select a template in the list to edit it; **Rename** changes its name. * **Make default** marks the template used when nothing picks one explicitly — new quotes start on it, and quotes created from the mobile app or by AI generation use it. * **Delete** removes a template you no longer offer. The default template can't be deleted — make another template the default first. Existing quotes keep the design they were created with. With more than one template, the quote form shows a **Template** dropdown so you choose the design per quote (see [Create a quote](/revenue/quotes/create-a-quote.md)). With a single template, nothing changes — every quote uses it automatically. ## Include items and pricing Select a saved template in **Settings -> Quotes -> Quote**, then set **Include items and pricing** and click **Save template**. The preview updates immediately; **Discard changes** restores the saved setting. In Settings search, enter **Include items and pricing** or **scope-only** to open the **Quote** tab directly. The setting starts on. Turn it off for a scope-only proposal: new quotes using this document template omit line items, sales tax, discounts, totals, and the pricing table. This applies to quotes created from scratch and quotes drafted with AI, regardless of the AI prompt selected. You can save, send, and sign without an item or dollar amount; Terms & Conditions and required custom fields still apply. Each new quote keeps a copy of the setting. Editing the template later does not change the pricing mode of existing quotes. Quote lists and Quote Performance display a dash for scope-only quotes. Monetary report totals include only priced quotes, and the assistant does not treat scope-only history as a zero-dollar price. ## Customize the design If you have permission to edit the template, **Edit template** above the preview (or **Customize** on a style card under **Browse styles**) opens the full-screen editor on the rendered document. Click any text to change it, use **Insert variable** to add details such as the customer's name, and switch the sample customer, property, and line items in **Sample data** to check the layout. Switch to **Edit code** for layout, styling, and logic in the Liquid source. See [Edit a document template's design](/administration/settings/edit-a-document-templates-design-with-edit-code.md). A red notice means the template has an error and can't be saved until you fix it; a yellow one flags a variable that doesn't exist — see [Errors and warnings](/administration/settings/edit-a-document-templates-design-with-edit-code.md#errors-and-warnings). Built-in quote templates show the quote's **Valid through** date when you select them. An untouched saved built-in style remains eligible for automatic built-in updates; a customized template is not rewritten. To place the date in a customized template, insert the **Valid through** variable; **Validity (days)** is also available when you need the numeric period. Built-in templates also print the PO number and any custom fields marked **Show on customer document**. In a customized template, insert the **Custom fields (built-in block)** variable once to print them in the standard style — or use **Custom fields (custom layout)** to control the markup around each field yourself. Built-in styles don't print pricebook item codes. If you want a code (SKU) column on the document, add it in Edit code with the **Item code (when known)** variable - see [Edit a document template's design](/administration/settings/edit-a-document-templates-design-with-edit-code.md#show-item-codes-on-the-document). If **Edit template** or **Customize** is missing but you need to change the template, contact your business's administrator to review your role. **Save template** applies your changes, or **Discard changes** reverts. Your Business Profile branding (logo, brand color) flows into the preview automatically. If you have additional offices or brands, use **Preview office and brand** above the document to switch among every configured combination and check its name, color, logo, address, and phone number. On a real quote, Essential chooses the branding from the selected property's office. A property override wins; otherwise the quote inherits the customer's office. The office provides the address and phone number, and its default brand provides the name, color, and logo. Main-office properties use the Business Profile values. While you use a built-in style as-is, it is eligible for automatic updates when Essential improves that style. Opening the editor does not change this tracking by itself. If you change the template - in Visual or Edit code - and save it, the template is treated as your custom version and stays as saved instead of receiving later built-in changes. Re-selecting a style from the library and saving puts you back on the auto-updating built-in. Essential's built-in styles keep sales tax compact. When one tax entry applies, taxable line items show a checkmark in the Tax column and the summary shows **Sales Tax** with its percentage. When several tax entries apply - including entries with the same percentage but different agencies or jurisdictions - the document names and totals each one separately. A customized template keeps its own tax layout. ![Quote settings](https://3838208579-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Flu1pgNH0CrkCPslG8suQ%2Fuploads%2Fgit-blob-6da13bec08ba2240b0a8a4be83dc6bc4f05c8b09%2Fsettings-quotes.png?alt=media) > **Where to find it:** Settings -> Quotes, the Quote template section ## Related guides * [Choose and customize your invoice document template](/administration/settings/choose-and-customize-your-invoice-document-template.md) * [Create Terms & Conditions sets for quotes](/administration/settings/create-terms-and-conditions-sets-for-quotes.md) * [Edit a document template's design](/administration/settings/edit-a-document-templates-design-with-edit-code.md) * [Set up quote prompt templates for AI drafting](/administration/settings/set-up-quote-prompt-templates-for-ai-drafting.md) * [Add or edit a pricebook item](/administration/settings/add-or-edit-a-pricebook-item.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://learn.withessential.com/administration/settings/choose-and-customize-your-quote-document-template.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.