> ## 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.

# Create an offer

> How to create an offer and build it in the builder: insert and arrange sections, edit text, check the preview and read the offer score.

An offer is a page made of sections. You create it, build it in the builder and then send it. This page shows the way to a finished draft. The individual section types are described under [Sections](https://docs.hocdoc.com/en/guides/sections.md).

## Create an offer

There are three ways, plus the interview after a call and the import of a file. Each one creates a draft and then opens the offer's detail page. From there, **Open in the builder** takes you to the builder. Only the import opens the new draft directly in the builder.

> [!NOTE]
>
> The roles Owner, Admin and Member can create, edit and duplicate offers. With the Viewer role you only see the builder in read-only mode (see below). More under [Team and roles](https://docs.hocdoc.com/en/guides/team-and-roles.md).

### New offer

**1. Open a new offer**

In the offer list, click **New offer**.

**2. Create**

Under **New offer**, click **Create offer**. The offer starts with the standard structure: Intro, Columns (three key points), Schedule, References, Pricing, Assurance, FAQ and Acceptance. Every section comes with sample text.

**3. Open in the builder**

On the detail page, click **Open in the builder**. You change the title and content there.

### From template

Under **From template** you see your templates with their number of sections. Click **Use template**. If the template has questions, the button first leads to the **Questions for the offer** page. Your answers fill the variables in the texts. Only then is the offer created. More under [Templates and variables](https://docs.hocdoc.com/en/guides/templates-and-variables.md).

If there is no template yet, you see **No templates yet**. You turn an offer into a template on its detail page with **Save as template**.

### Start with an interview

Under **New offer** there is the card **Start with an interview**. After a customer call you answer seven questions, and an AI model writes sections of the draft from them. More under [Interview after the call](https://docs.hocdoc.com/en/guides/interview.md).

### Import from file

Under **New offer** there is also the card **Import from file**. You upload an existing offer as a PDF or Word file, an AI model turns it into a draft, and you review it in the builder. More under [Import an existing offer](https://docs.hocdoc.com/en/guides/import-an-offer.md).

### Duplicate an offer

Open the action menu of a row in the offer list, or the detail page of an offer, and choose **Duplicate**. The copy is a new draft titled "Title (copy)". Copying a copy gives "Title (copy 2)" and so on.

The copy takes over the draft and the answers to the template's questions. It has no recipient. The original's history is not copied. The copy starts with its own entry "Offer created". More about the two pages you duplicate from is under [Offer list](https://docs.hocdoc.com/en/guides/offer-list.md) and [Offer detail page](https://docs.hocdoc.com/en/guides/offer-detail.md).

## Layout of the builder

The builder fills the whole screen and has three areas.

| Area | Content |
| - | - |
| Left | Three tabs: **Sections**, **Structure** and **Variables** |
| Center | The canvas with the offer. You edit text directly here. |
| Right | Settings of the selected section or of the whole offer |

At the top is the bar with the **Back to offer** arrow, the title, the save status, the device switcher, the score, **Undo** and **Redo**, **Preview** and **Send**.

### The three tabs on the left

* **Sections** shows all section types you can insert, with a short description. Current situation, Cost of waiting, Goal and outcome and Scope of work only exist in existing offers. This is where you insert new sections.
* **Structure** shows the order of your sections as a list. This is where you sort, hide, duplicate and delete.
* **Variables** shows the placeholders you can use in texts and the answers from the interview. A click copies a placeholder to the clipboard. See [Templates and variables](https://docs.hocdoc.com/en/guides/templates-and-variables.md).

### Settings on the right

If no section is selected, the right side shows **Offer** with the fields **Title**, **Theme** and **Language**. For the theme there is only **Default**. For **Language** you choose German or English as long as the offer is a draft that has never been sent (see [Language per offer](https://docs.hocdoc.com/en/guides/language-per-offer.md)). The title must not be empty and can have at most 200 characters. You can also change it in the bar at the top.

If a section is selected, the right side shows its name and below it **Content** with all fields. If the section has more than one selectable layout, **Layout** appears above it, with the variants as tiles with a preview.

**Content** contains all fields of the section. For Pricing, References and FAQ there is also **Insert from library**. Conversely, you save a package, an add-on, a testimonial or a question to the library with the bookmark icon on the entry. See [Library](https://docs.hocdoc.com/en/guides/library.md).

Next to the text fields, on the Pro and Team plans and with write access, there is the **AI** button, which lets you shorten, rephrase or translate the text (see [AI writing assistant](https://docs.hocdoc.com/en/guides/ai-writing-assistant.md)).

Next to the name there is a menu with **Duplicate**, **Hide** and **Delete**. It is missing for the acceptance.

Lists such as packages, steps or questions have the **Add** button. It creates a copy of the last entry, which you overwrite. It is locked once the maximum number is reached. You sort entries by dragging the handle or with the keyboard, and remove them with the trash icon. Removing is locked while the list only has its minimum number of entries.

## Insert sections

The **Sections** tab shows the library as tiles. Each tile has a sketch of the section. If you rest the mouse on a tile, a large preview appears. You have two ways:

* **Click** (or Enter or Space on the card): The section goes directly below the selected section. If none is selected, it goes before the acceptance.
* **Drag** (mouse only): Drag the card onto the canvas. A line shows where the section will land.

The new section starts with sample text and is selected right away. Replace the sample text before you send.

You deselect a selected section by clicking a second time on an empty spot of the page.

The acceptance may only appear once. Its card therefore shows **Added** and the note "Already in the offer and can only appear once."

## Move sections

You can arrange sections in three ways:

* **With the mouse**: Drag the handle in a section's toolbar on the canvas, or in the list in the **Structure** tab.
* **With the arrows**: The toolbar of every section has **Move up** and **Move down**.
* **With the keyboard**: Focus a section's handle (for example "Move Pricing"), press Space to pick the section up, move it with the up or down arrow and drop it with Space. Escape cancels. Screen readers announce the new position.

The acceptance can be moved like any other section.

## Duplicate, hide, delete

You find these actions in three places:

* in the toolbar on the canvas (it appears on hover and on the selected section),
* in the **Structure** tab: the eye hides and shows, and the row's menu contains **Duplicate** and **Delete**,
* in the menu next to the section's name on the right.

| Action | Effect |
| - | - |
| **Duplicate** | Creates a copy directly after the section and selects it. |
| **Hide** / **Show** | A hidden section stays in the draft, but appears neither in the preview nor for the recipient. On the canvas it is dimmed and labeled "Hidden". It does not count toward the offer score. Errors in its fields still block sending. |
| **Delete** | Removes the section without asking. **Undo** brings it back. |

> [!WARNING]
>
> The acceptance is a required section. It cannot be deleted, hidden or duplicated ("Only once per offer"). Without an acceptance, the recipient cannot accept the offer.

## Edit text directly on the canvas

Click into a text on the canvas and type. This also applies to button labels. You change the layout and all other fields, such as prices, on the right in the settings.

* **Enter** confirms the text. In multi-line texts (for example subtitle or answer), Enter inserts a line break. There you confirm with Ctrl+Enter or ⌘+Enter.
* A click outside the text also confirms it.
* **Escape** discards your input.
* When you paste from the clipboard, only plain text arrives. Formatting is lost.

You clear the section selection by clicking the background or pressing Escape (as long as you are not typing in a text).

### Add and remove empty optional texts

Some texts are optional, for example the **Eyebrow** in the intro. If such a text is empty, the canvas shows a dashed area with a plus and the field's name, for example "Add eyebrow".

* **Add**: Click the area (or focus it and press Enter or Space) and type. Opening does not save anything yet. Only a confirmed text is saved.
* **Remove**: Delete the whole text and confirm the empty input. The area comes back. A text consisting only of spaces counts as empty.

You create empty lists and the description of add-ons only in the settings on the right. You also enter a video's link there. On the canvas, a video without a link only shows the note "Insert video link".

## Autosave

You do not need to save. The builder saves the draft about 0.8 seconds after your last change. It saves immediately when you leave a field, the window loses focus or you switch tabs.

Next to the title, the bar shows the status:

| Display | Meaning |
| - | - |
| **Saved** | Everything is saved. |
| **Saving …** | A change is not saved yet or is in transit. |
| **Not saved, try again** | Saving failed. Clicking "try again" restarts it. |
| **Conflict: changed in another tab** | The offer has been saved elsewhere in the meantime. The builder overwrites nothing and stops saving in this tab. **Reload** fetches the current state. Unsaved changes from this tab are lost in the process. |

If you leave the page with unsaved changes, the builder tries to save once more and the browser asks for confirmation.

A draft cannot grow without limit. If it gets too large, the builder reports: "The draft is too large to save. Shorten text or remove blocks."

### Undo and redo

With **Undo** (⌘Z or Ctrl+Z) and **Redo** (⇧⌘Z, ⌘Y or Ctrl+Y) you take changes back or restore them. While you type in a text field, the field's own undo applies instead. Several inputs in the same field within about one second count as one step. The builder remembers at most 200 steps, and only while it is open. After a reload the history is empty.

### After sending

After sending, the builder stays open for changes to the draft. The version that was already sent does not change as a result. The button at the top is then called **Resend**. Only that sends your changes to the recipient. More under [Sending](https://docs.hocdoc.com/en/guides/sending.md).

If the offer is accepted, declined or withdrawn, **Send** is locked.

## Preview and device view

With the device switcher at the top you switch the canvas: **Desktop**, **Tablet** (768 px) and **Mobile** (390 px). The sections adapt their layout to the width.

The canvas and the preview carry your workspace's color, font and logo bar, like the recipient's page (see [Brand](https://docs.hocdoc.com/en/guides/settings.md#brand)). The brand only sits on the sections. Markers, selection frames and the fields on the right stay in HocDoc's design.

**Preview** opens the draft in a new tab, without the builder interface and with the same blocks as the recipient's page. The builder saves first.

In the preview:

* Hidden sections are missing.
* Known variable values are filled in. Placeholders without a value stay in place and are highlighted. A note says "Highlighted placeholders are filled in when you send."
* The calculators work. A video only loads after a click.
* The acceptance buttons do nothing. The flow with name, email address and code only exists on the recipient's page.

## Hints and readiness to send

If the draft has errors, the bar shows a button with their number next to the score, for example "2 hints". The list names errors in fields, such as an empty required field or a package list that is too short. A click on a hint selects the section.

Drafts are saved despite hints. As long as the draft has errors, **Send** is locked. The tooltip names the first error ("Not ready to send: …").

## Offer score

The score in the bar (for example "Score 85") rates the structure of your offer from 0 to 100. A click opens the list of hints. If a hint belongs to a section, one click takes you there. On the canvas and in the list in the **Structure** tab the section is marked.

The score is a recommendation. You can always send. The only exception is open variables: they block sending.

The score starts at 100. Each hint deducts points:

| Weight | Deduction |
| - | - |
| High | 25 points |
| Medium | 15 points |
| Low | 10 points |

The levels are **Strong** (from 85), **Solid** (from 60) and **Gaps** (below).

| Hint | Weight | When it appears |
| - | - | - |
| Open variables | High | A placeholder in a visible section has no value. The placeholders `{{name}}`, `{{company}}`, `{{firma}}`, `{{email}}` and `{{valid_until}}`, `{{gueltig_bis}}` do not count in the builder. Their values are only set in the send dialog. |
| Proof missing | High | There is no visible References section with at least one entry. Only the list of the selected layout (quotes or logos) is counted. |
| Price comes before value | High | The first Pricing section comes before the first value section, or there is no value section. ROI calculator and Custom calculator count as value, and in existing offers also Current situation, Cost of waiting and Goal and outcome (these three can no longer be inserted anew). To fix it, you can insert ROI calculator, Custom calculator, or Columns or Free text before the pricing. If a visible Columns or Free text section comes before the first Pricing section, the hint does not appear either. Without a Pricing section the hint does not appear. |
| Assurance missing | Medium | There is no visible Assurance section with at least one commitment that has a title. Alternatively, a keyword such as "guarantee" or "fixed price" in the text of another visible section is enough. |
| Objections unanswered | Medium | There is no visible FAQ section with at least one answered question. |
| Video without a link | Medium | A visible Video section has no link. The recipient would only see the heading and text. The hint reads: "The "Video" section has no link. The recipient only sees the heading and text. Add a link or hide the section." It does not block sending and appears in the builder and in the send dialog. |
| Calculator divides by zero | Medium | A visible Custom calculator divides by zero at a slider position between the limits. The hint reads: "The formula divides by zero when B = 100. The recipient then sees your fallback text instead of a result. Adjust the formula, the limits or the step size." It names the input and its value, for B - 100 for example "B = 100". It does not block sending. If the section itself already reports an error in the formula, start values or limits, this hint does not appear in addition. |
| Objection from the call not answered | Medium | If you recorded objections in the [interview](https://docs.hocdoc.com/en/guides/interview.md) or via transcript, the score checks whether the offer answers them. One message per open objection, at most three, 15 points each. The hint names the objection and suggests a section, for example "Assurance" for a price objection. A click inserts the section or jumps to it. It does not block sending. The check runs without AI. |
| Too many packages | Low | All visible Pricing sections together have more than 3 packages. |
| No expiry date | Low | No "Valid until" is set in the send dialog. This hint is not evaluated in the builder. |

The check of objections from the call detects them rule-based in five categories (price, timing, trust, internal decision makers, alternatives), in German and English, and matches them against the sections and the entries in "FAQ". It recognizes words, not meaning. The short summary for co-decision makers does not count as an answer.

The score is not saved. It is recalculated on every change, using your saved answers in the **Variables** tab.

## Read-only mode for viewers

With the Viewer role you open the builder via **View in the builder** in read-only mode. The bar shows **Read only**, and a note explains: You have read access and can view the offer, but not change it. On the left there is only the structure as a list to select from, and the settings on the right are missing. Score and **Preview** remain. Nothing is ever saved.

## Limit on narrow screens

The builder needs at least 900 pixels of width. On narrower screens you see the notice **The builder needs a larger screen** instead of the builder, with two options: **View preview** and **Back to offer**. Open the offer on a laptop or desktop to edit it. Preview and offer page also work on a phone.

## Next

* [Sections](https://docs.hocdoc.com/en/guides/sections.md): all types, layouts and limits
* [Templates and variables](https://docs.hocdoc.com/en/guides/templates-and-variables.md)
* [Sending](https://docs.hocdoc.com/en/guides/sending.md)


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