> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hocdoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sections

> All section types at a glance: what they are for, which layouts exist, which fields matter and where the limits are.

An offer consists of sections. Each section has a type, a layout and its content. You choose the layout on the right in the settings under **Layout**, the content under **Content**. How you insert and arrange sections is described under [Create an offer](https://docs.hocdoc.com/en/guides/create-an-offer.md).

New sections start with sample text. Replace it before you send.

## What HocDoc designs and what you set

The look of the offer page follows fixed rules. You do not have to set any of it.

**HocDoc designs:**

* **Measure:** The offer page has its own font size and a fixed width. On a phone, tablet and desktop the measure adapts.
* **Header:** Every section begins with the same header made of a heading and, where there is one, an introduction.
* **Surface alternation:** As long as you choose nothing, the surfaces of the sections alternate automatically between light and tinted. The intro sits on a dark surface derived from your primary color. The acceptance sits on a light or tinted surface. Divider and image take over the surface of the section before them. You can choose the background of each section yourself (see below).
* **Spacing and columns:** They follow the order of the sections and the number of your entries.

**You set:**

* **Variant:** For each section you choose the layout (see below).
* **Background:** For each section you choose the surface (see below).
* **Primary color, font and logo:** You set them in [Settings](https://docs.hocdoc.com/en/guides/settings.md). From the primary color, HocDoc calculates the tinted and the dark surface.

The new look applies to all offers, including those already sent. Content and the proof of acceptance do not change as a result.

### Background per section

When a section is selected, the right side shows the **Background** choice with **Automatic**, **Light**, **Tinted** and **Dark**.

* **Automatic** is the default. The surface then alternates as described above.
* **Light**, **Tinted** and **Dark** fix the surface of this section. This applies to the recipient's page and to the preview.
* The **Acceptance** only offers **Light** or **Tinted**, never a dark surface.
* **Divider** and **Image** have no choice. They take over the surface of the section before them.

### Lock

At the very bottom of a section's settings is the **Lock**. Only admins and owners can change, move and delete locked sections. The lock is available on the Team plan. On other plans a hint with the "Team" badge appears there.

## Overview

Names and order match the **Sections** tab in the builder. The builder no longer offers Current situation, Cost of waiting, Goal and outcome and Scope of work for insertion. They only exist in existing offers.

| Section | Purpose | Layouts |
| - | - | - |
| Intro | Headline and subheadline, the first impression | Centered |
| Video | A video via link that only loads after a click | Stacked, Side by side |
| Current situation | The customer's situation in their words | Body text, With key points |
| Cost of waiting | Shows what the current state costs | Three key figures, Total highlighted |
| Goal and outcome | What the customer has achieved after implementation, in a few points | Checklist, Cards |
| Schedule | Implementation steps with timing and responsibility | Step sequence |
| Scope of work | What is included and what is not | Stacked, Two columns |
| References | Testimonials or logos | Quotes, Logos |
| Pricing | One to four packages, optionally with add-ons. The recipient chooses a package and ticks add-ons | Cards |
| ROI calculator | The recipient sets numbers and sees added value, ROI and payback | Side by side, Result on top |
| Custom calculator | Your own inputs and your own formula | Side by side, Result on top |
| Assurance | Commitments such as fixed price, guarantee or payment terms | Cards |
| FAQ | Answer objections | Accordion, Two columns |
| Team | The people behind the offer with role, short text and photo | Cards, List |
| Next steps | What happens after acceptance, step by step | Tiles |
| Free text | Heading and body text for everything else | Body text, Callout |
| Image | Your own image with an optional caption | Reading width, Full width |
| Columns | Two or three text columns side by side | Boxes |
| Divider | A line or a space between two parts | Line, Spacing |
| Acceptance | The recipient accepts the offer with electronic confirmation | Plain, With note |

The Layouts column only names the layouts you can choose. Older layouts (Intro Left-aligned, References Case studies, Schedule Compact list, Pricing Table, Assurance Compact list, Next steps Numbered list, Columns Plain) can no longer be newly chosen. Existing offers keep showing them. If a section only has one selectable layout left, the **Layout** part in the settings is dropped.

New offers start with Intro, Columns, Schedule, References, Pricing, Assurance, FAQ and Acceptance. You add all other sections yourself.

The summary for co-decision makers only uses content from Intro, Goal and outcome, Current situation, Pricing, ROI calculator and Assurance. All other sections are missing there.

## The sections in detail

Fields marked "optional" may stay empty. On the canvas, empty optional texts show an area to create them (see [Create an offer](https://docs.hocdoc.com/en/guides/create-an-offer.md)). Images, Video, ROI calculator and Custom calculator have their own sections further down.

You enter amounts as a number. The currency is shown on the field, for example "Price (EUR)". Amounts of new sections are in EUR. The currency cannot be changed in the builder, and the workspace's currency is not taken over.

### Intro

The start of the page.

* Fields: **Eyebrow** (optional), **Headline**, **Subheadline** (optional), **Note for recipient** (optional).
* The **Headline** is required.
* The intro has no button.

### Current situation

Describes the customer's situation and the problem your offer solves.

* Fields: **Headline**, **Text**, **Key points**.
* The **Key points** only appear in the **With key points** layout. In the **Body text** layout they stay saved but invisible.
* **Headline** and **Text** are required. A key point must not be empty.

### Cost of waiting

Shows what the current state costs per week, per month and over a period. The section only displays. The recipient cannot set anything.

* Fields: **Headline**, **Introduction** (optional), **Cost label**, **Amount**, **Amount applies per** (**Week** or **Month**), **Period in months**, the labels of the three results and **Note on start date** (optional).
* Limits: The period is between 1 and 120 months. The amount may be at most 500 million (for currencies with two decimal places such as EUR). Above that the builder reports "Amount is too large."
* The calculation uses your values. Week and month are converted with the fixed factor of 52 weeks to 12 months. The total is the monthly value times the months of the period.
* The **Note on start date** is free text without date logic.

### Schedule

Implementation steps.

* Fields: **Headline**, **Introduction** (optional), **Steps** with **Title**, **Timing** (optional), **Description** (optional) and **Responsibility**, plus **Responsibility: text for provider** and **Responsibility: text for customer**.
* **Responsibility** has the values **Not stated**, **Provider** and **Customer**. With **Not stated** no badge appears. The sample texts of the badge are "We take care of this" and "Your contribution".
* Limits: at least 1 and at most 12 steps. Title at most 120 characters, timing 40, description 600.
* The **Timing** is free text, for example "Week 1 to 2". There is no date logic.

### References

Testimonials or logos.

* **Quotes** layout: **Testimonials** list with **Quote**, **Name**, **Role** (optional) and **Company** (optional).
* The retired **Case studies** layout (existing offers only): **Case studies** list with **Title**, **Customer** (optional), **Description** (optional) and **Result** (optional). At most 6 case studies. Title at most 160 characters, customer 120, description 1000, result 300.
* **Logos** layout: **Logos** list with **Name** and **Logo**. You upload the logo (see [Images](#images)). There is no field for an image address. A logo without an image appears as its name.
* The recipient only sees the list of the chosen layout. The settings always show all of them.
* With **Insert from library** you bring quotes into the offer as testimonials. This only exists in the **Quotes** layout. If your quotes carry tags, you choose which ones under **Matching** in the dialog. Quotes with the most matches then appear at the top. The entry comes into the offer as a copy. See [Library](https://docs.hocdoc.com/en/guides/library.md).

### Pricing

One to four packages, plus add-ons to tick. The recipient chooses a package on the offer page and ticks which add-ons they want. Their choice is saved with the acceptance (see [Recipient's choice](https://docs.hocdoc.com/en/guides/acceptance-and-certificate.md#recipients-choice)).

* Fields: **Eyebrow** (optional, at most 80 characters), **Headline**, **Description** (optional, at most 400 characters), **Packages** with **Name**, **Description** (optional), **Price**, **Billing** (optional), **Lines below the price** (optional, up to 3, each with **Label** and **Value**), **Note when this package is chosen** (optional, at most 120 characters), **Features** and **Highlight as recommended**. Plus **Add-ons** with **Name**, **Description** (optional), **Price**, **Billing** (optional) and **Ticked when opened**. Also **Label for the choice** (optional, at most 40 characters) and **Fine print below the choice** (optional, at most 600 characters).
* Limits: at least 1 and at most 4 packages. There is no maximum number of add-ons.
* **Fixed price or choice:** A single package without add-ons is a fixed price. The recipient cannot click anything, and everything works as without a choice. Two to four packages are a choice, and exactly one package is chosen. Add-ons can also be offered with a single package, and the recipient can then tick them.
* **Preselection:** When opened, the package with **Highlight as recommended** is chosen, otherwise the first. Add-ons are only ticked if you set **Ticked when opened**.
* **Billing:** Write the billing in words, for example "one-time" or "per month". The page adds up amounts with the same word and the same currency into one total. One-time and monthly amounts stand side by side and are not added.
* Below the packages is a line with the choice, for example "Your choice: Complete + Support" and the total. You set the label before it under **Label for the choice**, and without an entry it says "Your choice". The **Note when this package is chosen** appears in this line as long as the package is chosen. For a fixed price (one package without add-ons) this line does not exist, so the note does not appear.
* For an add-on, the page shows name, description, price and billing. Empty optional details are dropped.
* The **Table** layout is retired and can no longer be newly chosen. Existing offers with a table keep showing it, and each row can be clicked like a card. The description and the **Lines below the price** are only shown by the **Cards** layout. The recommendation is highlighted in both layouts (eyebrow "Recommended"). For cards there is no layout choice in the settings anymore.
* Several Pricing sections are possible. The choice then applies per section. An offer can be sent with at most 20 Pricing sections with a choice. If packages and add-ons together are too extensive for the acceptance, the builder reports it before you send. Remove add-ons or shorten names then.
* With **Insert from library** you bring services into the offer, with **As package** or **As add-on**. If 4 packages are already there, **As package** is locked.
* Every price carries its own currency. If you insert a service in a different currency than the existing prices, the builder shows a note. There is no lock and no conversion.
* More than 3 packages across all Pricing sections together trigger the "Too many packages" hint in the offer score. That blocks nothing.

### Assurance

Commitments that take the risk off the recipient.

* Fields: **Headline**, **Introduction** (optional), **Commitments** with **Type**, **Title** and **Description** (optional), plus **Badge: Fixed price**, **Badge: Guarantee** and **Badge: Payment terms**.
* The **Type** of a commitment is **Fixed price**, **Guarantee (risk reversal)**, **Payment terms** or **Other**. It determines which badge sits on the commitment. For **Other** none appears. You change the text of the badges only in the settings, not on the canvas.
* Limits: at least 1 and at most 8 commitments. Title at most 120 characters, description 600.
* A visible Assurance with at least one commitment removes the "Assurance missing" hint in the offer score.

### FAQ

Answers objections before they become a hurdle.

* Fields: **Headline**, **Questions** with **Question** and **Answer**.
* Limits: at least 1 question, no maximum.
* In the **Accordion** layout the recipient expands the answers. In the builder all answers are expanded so you can edit them.
* With **Insert from library** you bring objections into the offer as questions.

### Goal and outcome

Describes what the customer has achieved after implementation.

* Fields: **Headline**, **Introduction** (optional) and **Outcomes** with **Title** and **Description** (optional).
* Limits: at least 1 and at most 6 outcomes. Headline and title at most 160 characters, introduction 1000, description 600.
* Layouts: **Checklist** (stacked) and **Cards**.
* The section provides the "Result" block of the summary for co-decision makers. More under [Acceptance and certificate](https://docs.hocdoc.com/en/guides/acceptance-and-certificate.md).

### Scope of work

Shows what is included in the offer and what is not.

* Fields: **Headline**, **Introduction** (optional), **Features** with **Title** and **Description** (optional), **Heading for what is not included** and **Not included**.
* Limits: at least 1 and at most 20 features, at most 12 entries under **Not included**. Headline and title at most 160 characters, introduction 1000, description 600, heading for what is not included 80, an entry under **Not included** 200.
* The "Not included" block only appears if there are entries.
* Layouts: **Stacked** and **Two columns** (included on the left, not included on the right).

### Team

The people behind the offer.

* Fields: **Headline**, **Introduction** (optional) and **People** with **Name**, **Role** (optional), **Short text** (optional) and **Photo** (optional).
* You upload the photo (see [Images](#images)). Without a photo, the person's initials appear.
* Limits: at least 1 and at most 8 people. Headline 160 characters, introduction 1000, name and role 120 each, short text 600.
* Layouts: **Cards** and **List**.

### Next steps

What happens after acceptance, numbered.

* Fields: **Headline**, **Introduction** (optional), **Steps** with **Title** and **Description** (optional) and **Note below the steps** (optional).
* Limits: at least 1 and at most 8 steps. Headline 160 characters, introduction 1000, title 120, description 600, note 300.
* There is no date logic. Layout: **Tiles**. Only existing offers show the retired **Numbered list**.

### Image

Your own image in the offer.

* Fields: **Image**, **Alt text (description of the image)** and **Caption** (optional). How to upload the image is described under [Images](#images).
* Layouts: **Reading width** and **Full width**.
* Without an image, the section stays empty on the recipient's page, and the caption does not appear either. In the builder you see a placeholder area.

### Columns

Two or three text columns side by side.

* Fields: **Headline** (optional) and **Columns** with **Headline** (optional) and **Text**.
* Limits: at least 2 and at most 3 columns. The section's headline 160 characters, a column's headline 120, text 2000. The text must not consist only of spaces or line breaks.
* It is plain text, as with Free text. Layout: **Boxes**. Only existing offers show the retired **Plain** layout.
* In the PDF the columns are stacked.

### Divider

A line or a space between two parts, without content.

* Field: **Size** with **Small**, **Medium** and **Large**.
* Layouts: **Line** and **Spacing**.

### Free text

For everything that no other section covers.

* Fields: **Headline** (optional) and **Text**.
* Limits: headline at most 160 characters, text at most 5000 characters. The text must not consist only of spaces or line breaks.
* It is plain text without formatting: no bold, no links, no lists. Line breaks are kept, and a blank line separates paragraphs.
* The **Callout** layout puts the text on a set-off surface.

### Acceptance

This is where the recipient accepts the offer.

* Fields: **Headline**, **Text** (optional), **Accept button** and **Note on the terms** (optional). The note only appears in the **With note** layout.
* Every offer has exactly one acceptance. It can be moved, but not deleted, hidden or duplicated.
* In the builder and the preview you see the button to accept, and there is no button to decline. On the recipient's page, the acceptance flow takes its place: the recipient enters name and email address, requests a code and confirms with it. The recipient's page has no way to decline. More under [Acceptance and certificate](https://docs.hocdoc.com/en/guides/acceptance-and-certificate.md).

## Images

Images exist in the **Image** block, as a photo in **Team** and as a logo in **References**. All three work the same way.

### Upload, replace, remove

The image field is in the form on the right. With **Upload image** you choose a file. During the upload it says "Uploading". Afterwards you see a preview. With **Replace image** you swap the file, with **Remove** you take the image out of the section.

* PNG and JPEG are allowed, up to 2 MB. The field says: "PNG or JPEG, 2 MB at most."
* At most 8000 pixels per side. For PNG, at most 8 megapixels.
* Each workspace can have at most 300 images. After that the field reports "This workspace has reached the limit of 300 images."
* You may upload from the Member role. With the Viewer role the field reports "You only have read access in this workspace."

You cannot enter the address of an image on the web. Images only get into the offer via upload.

### Alt text and caption

For the **Image** block you give an **Alt text (description of the image)**, at most 200 characters. It describes the image for everyone who cannot see it. The **Caption** is optional, at most 300 characters.

### Where images appear

* **Offer page**: The page shows all images of the sections.
* **Offer PDF**: The PDF contains the images of the sections, at most 20. If an image cannot be embedded or the limit is reached, text appears in its place: "\[Image: alt text]", the logo's name or the person without a photo. An image never prevents the PDF.
* **Summary for co-decision makers**: It shows no images.
* **Proof of acceptance**: The snapshot only contains alt text and caption, no image files.

## Video

The **Video** section shows a video from an external provider.

### Allowed providers

You enter the link on the right in the settings, in the field **Link to the video (YouTube, Vimeo or Loom)**. Only https links to these providers are allowed:

| Provider | Accepted links |
| - | - |
| YouTube | `youtube.com/watch?v=…`, `youtu.be/…`, `youtube.com/embed/…`, `youtube.com/shorts/…`, `youtube.com/live/…` |
| Vimeo | `vimeo.com/…` (also with the identifier for unlisted videos) and `player.vimeo.com/video/…` |
| Loom | `loom.com/share/…` and `loom.com/embed/…` |

Everything else is invalid: other providers, links without https, links with a username or port. Additions in the link such as timestamp or playlist are discarded.

An invalid link shows the error "Only links from YouTube, Vimeo or Loom (https)." and blocks sending. An empty field is allowed. The section then shows only **Headline** and **Text** to the recipient. In the offer score the hint "Video without a link" appears for it (see [Create an offer](https://docs.hocdoc.com/en/guides/create-an-offer.md#offer-score)). There is no sample link.

There is no upload, no thumbnail and no timestamp.

### What the recipient sees

Before the click there is a neutral surface with a play button, its label and the provider's name. Your **Note below the button** follows. The provider's player only loads when the recipient clicks. Before that, no request goes to the provider.

In the builder there is never a player. There you edit label and note directly on the canvas.

In the PDF the link appears as text. Whether the recipient started the video is not shown in the history.

### Fields and limits

| Field | Rules |
| - | - |
| **Headline** | Optional, at most 160 characters |
| **Text** | Optional, at most 1200 characters |
| **Link to the video (YouTube, Vimeo or Loom)** | At most 500 characters |
| **Play button label** | Required, at most 60 characters |
| **Note below the button** | Optional, at most 200 characters |

## ROI calculator

The recipient sets three values and sees how the investment pays off.

### What the recipient sets

| Input | You define |
| - | - |
| Baseline per month (amount of money) | Label and starting value |
| Improvement in percent | Label, minimum, maximum, step size, starting value |
| Period in months | Label, minimum, maximum, step size, starting value |

You set the investment in the field **Investment (fixed for the recipient)**. The recipient cannot change it.

### What the calculator shows

* **Added value over the period**: Baseline times improvement in percent gives the added value per month. The added value over the period is this value times the months.
* **ROI**: Added value over the period minus investment, divided by the investment, in percent.
* **Payback**: Investment divided by the added value per month, in months.

These are the sample texts of the three results. You can change them, as well as the **Note below the calculator**. If a figure cannot be calculated (ROI with an investment of 0, payback without added value), your text from **Result: text if not calculable** appears in its place (sample text "Not calculable").

### Limits

* Improvement: 0 to 1000 percent.
* Period: 1 to 120 months, in whole months.
* Amounts: at most 500 million for currencies with two decimal places such as EUR ("Amount is too large.").
* For every slider: The minimum is smaller than the maximum. The starting value lies in between. The step size is not larger than the distance from minimum to maximum. Maximum and starting value lie on the step size counted from the minimum.

### Evaluation and PDF

What the recipient sets in the calculator appears in the offer's history as "Calculator used" with the values. The history combines several uses in a row into one entry. More under [Analytics](https://docs.hocdoc.com/en/guides/analytics.md).

In the PDF the calculator appears with your starting values and the figures calculated from them. What the recipient set in the browser is not part of the PDF.

## Custom calculator

With the custom calculator you build a calculation for cases the ROI calculator does not cover, for example a price by quantity. You define inputs and a formula. There is a single result.

Besides inputs, formula and result, the section has the fields **Headline** (at most 160 characters), **Introduction** and **Note below the calculator** (both optional, at most 600 characters each).

### Inputs

Every input is a slider. You define: **Label**, **Unit** (optional), **Minimum**, **Maximum**, **Step size** and **Starting value**.

* At least 1 and at most 6 inputs.
* Minimum, maximum and starting value lie between 0 and 1,000,000,000. There are no negative inputs.
* The label may have at most 80 characters, the unit at most 12.
* The same rules apply to minimum, maximum, step size and starting value as for the ROI calculator's sliders.

The inputs carry letters. The first input is **A**, the second **B** and so on up to **F**. In the builder the letter sits on each input on the canvas and in the settings as "Input A", "Input B". The recipient does not see the letters.

> [!WARNING]
>
> The letters follow the order. If you re-sort the inputs or delete one, the letters shift, and the formula refers to different inputs. Check the formula after every change to the list.

The builder warns you itself: if deleting or re-sorting shifts the letters your formula uses, the hint reads, for example, "The formula uses B, which now points to a different input." and "Check the formula before you send." The builder never changes the formula on its own.

### Formula

The formula goes in the field **Formula (A, B, C for the inputs, + - \* / and parentheses. No thousands separator: 1500, decimals: 1.5 or 1,5)**.

| Allowed | Example |
| - | - |
| Numbers | `1500` or `0.19` |
| Letters of the inputs, upper or lower case | `A`, `b` |
| Plus, minus, times, divided by | `+`, `-`, `*`, `/` |
| Parentheses | `(A + B) * C` |
| Minus or plus before a value | `-A + 10` |

Rules for notation:

* **Decimal numbers** you write with a period or a comma (`1.5` or `1,5`). In an English offer only the period applies (see [Language per offer](https://docs.hocdoc.com/en/guides/language-per-offer.md#calculators-in-english-offers)).
* **Thousands** you write without a separator (`1500`). The builder rejects a number like `1.500` because it is ambiguous.
* **Multiplication signs** you always set yourself. `2A` or `A(B)` is invalid, the correct form is `2 * A` or `A * (B)`.
* There are no functions and no custom names, only the letters of the existing inputs.
* Spaces do not matter.

Limits of the formula:

* at most 200 characters,
* at most 80 components (numbers, letters, operators and parentheses),
* at most 12 nested parentheses or signs,
* single numbers at most 15 characters long and at most 1,000,000,000,000 in size,
* result and intermediate results at most 1,000,000,000,000,000, above that the formula counts as not calculable.

### Result

You define: **Result: label**, **Result: unit** (optional, at most 12 characters), **Result: decimal places** (0 to 2) and **Result: text if not calculable**.

### What happens with errors

The builder checks the formula while you edit and reports at the field what is wrong. For example:

* "Unexpected character at position 5. Allowed are numbers, the letters of the inputs, + - \* / and parentheses."
* "The formula is incomplete or malformed at position 7."
* "A parenthesis is not closed."
* "The formula uses D, this input does not exist."
* "The formula is too long or nested too deeply."

The builder also calculates the formula with the starting values and at the slider limits: every input used at its minimum and at its maximum, in all combinations. If the formula divides by zero or the result gets too large, the builder reports it, at the limits with the input concerned ("The formula divides by zero when B = 0. Adjust the limits of the input or the formula."). An error in the formula blocks sending until you fix it.

Errors in starting values and limits block sending. If the formula only divides by zero at a position between the limits, that does not block. The hint "Calculator divides by zero" then appears in the [offer score](https://docs.hocdoc.com/en/guides/create-an-offer.md#offer-score). For this, the builder checks all positions up to 4,096 combinations of the inputs in the divisor. Above that, it runs once through each input's range in the divisor, with the other inputs staying at their starting value. It skips inputs with more than 10,000 positions. Above 4,096 combinations there can therefore be a position the hint does not find, for example if the divisor only becomes zero through the interplay of two inputs. That then only shows for the recipient: instead of a result, your text from **Result: text if not calculable** appears. The calculator does not break.

### What is saved

The recipient's inputs are not saved. Unlike the ROI calculator, no entry appears in the history. The PDF contains the inputs with their starting values and the result. The formula itself is not in the PDF, and the recipient does not see it either.

## Next

* [Create an offer](https://docs.hocdoc.com/en/guides/create-an-offer.md)
* [Library](https://docs.hocdoc.com/en/guides/library.md)
* [Templates and variables](https://docs.hocdoc.com/en/guides/templates-and-variables.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.