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

# AI writing assistant

> Shorten, rewrite and translate texts in the builder with AI: where the menu is, what goes to the AI and which limits apply.

The AI writing assistant revises a single text in the builder. You choose whether it **shortens**, **rewrites** or **translates** the text, and you see a suggestion. Your offer only changes when you choose **Accept**. An AI model from Anthropic (Claude) writes the suggestion.

> [!NOTE]
>
> The writing assistant is available on the Pro and Team plans and only with write access (Owner, Admin and Member). On the Starter plan and for viewers the menu is missing. More under [Team and roles](https://docs.hocdoc.com/en/guides/team-and-roles.md).

## Where the menu is

In the [builder](https://docs.hocdoc.com/en/guides/create-an-offer.md), select a section. In the settings panel on the right, under **Content**, you see every text field of the section, including the entries of simple lists. Next to a text field's label is the **AI** button. It opens the "AI writing assistant" menu. For an empty field the button is missing.

The menu is also on the canvas: Click into a text and the **AI** button appears below it. The actions, the quota and the preview are the same as in the panel.

Fields where the AI has no business have no menu: identifiers, paths and addresses, formulas, units and very short fields with at most 11 characters. On the canvas the menu is also missing for locked sections and in read-only mode.

## What the menu can do

| Entry | What the AI does |
| - | - |
| **Shorten** | Shortens clearly, to at most 70 percent of the characters. Language and tone stay, nothing new is added. |
| **Rewrite** | Rewrites the text in a tone: **Factual**, **Personal** or **Persuasive**. Language stays, length stays similar, the text does not get longer than the original. |
| **Translate** | **To English** or **To German**. The AI translates naturally and in business style, not word for word. Into German it writes in the formal "Sie" form, unless the original is clearly casual. |

The AI is supposed to leave facts, numbers, prices, names and deadlines unchanged and add nothing. There is no check of the content. So read every suggestion before you accept it.

## Hints in the preview

HocDoc additionally checks every suggestion for shortening, rewriting and translating for details that are not in the original: numbers, percentages, amounts, dates, links, email addresses and names. If the check finds something, the suggestion is followed by: "New in the suggestion, not in the original: …. Check that this is correct." Details that are only written differently (for example "40%" instead of "40 percent") report nothing. You can still accept the suggestion. The check only detects details of this kind. A newly inserted sentence without a number or name is not detected.

For shortening there is an additional rule: If the suggestion is not shorter than your text, HocDoc discards it. If it is shorter but still over 70 percent of the length, you see it with the note "Shortened by only … percent. You can apply it or shorten again."

## How to proceed

**1. Open the menu**

Click **AI** next to the text field. Below the entries it says where the text goes ("The text in this field is sent to" followed by the provider's name) and what you have left ("299 of 300 suggestions left this month.").

**2. Choose a task**

Choose **Shorten**, a tone under **Rewrite** or a language under **Translate**. While the AI works, it says "The AI is working on your text."

**3. Review the suggestion**

The **AI suggestion** appears below the field. Your text in the field is still unchanged.

**4. Accept or discard**

**Accept** puts the suggestion into the field. It is saved like any other input: autosave and versions work as usual. **Discard** closes the suggestion. If you change the text while a suggestion is open, the suggestion expires.

If the AI found nothing to change, it says "The AI found nothing to change here." There is then nothing to accept.

The AI only works on click. HocDoc never calls it on load or in the background and stores no suggestions. A second click is a second request.

## Placeholders

Placeholders such as `{{company}}` or `{{firma}}` must be kept character for character in the suggestion (see [Templates and variables](https://docs.hocdoc.com/en/guides/templates-and-variables.md)). HocDoc checks this. If a placeholder is missing, one was added or one is written differently, HocDoc discards the suggestion: "The suggestion changed a placeholder and was discarded. Your text is unchanged. The request still counts against your quota." When shortening, a duplicated placeholder may drop out once, but never completely.

The writing assistant does not use em dashes. If they appear in the suggestion anyway, HocDoc replaces them. Range dashes between numbers such as "19–22" stay.

## What goes to the AI

Only the text of the one field goes to Anthropic (Claude), plus the task and the field's upper limit. The offer's title, the recipient, other texts of the offer and data from other workspaces are not sent. HocDoc does not store the text and writes it into no logs. If the field contains names or prices, they go along, because you wrote them into the field.

## Limits

* **Length:** A field may have at most 4000 characters. For a longer text the **AI** button is locked, and below the field it says: "The AI writing assistant handles up to 4000 characters. This field has …" HocDoc never shortens the text to send it anyway. A suggestion also must not be longer than the field allows. Otherwise HocDoc discards it.
* **Empty field:** Without text there is no button. Write some text first.
* **Monthly quota:** The writing assistant has its own quota, separate from the quota for drafts, transcripts, imports and Deal coach. The Pro plan has 300 suggestions per calendar month, the Team plan 750, counted per account across all your workspaces. Every click counts as one suggestion. When the quota is used up, the entries are locked, and the menu says: "You have used all your text suggestions for this month. You can use them again from" followed by the date of the start of the month.
* **Daily limit:** At most 100 suggestions per account and day (across all your workspaces) and 500 per workspace. You can continue the next day.
* **Errors count:** If the provider does not respond in time, is unreachable, refuses, the answer is unusable, or the suggestion is discarded because of a placeholder, its length, or because it is not shorter when shortening, your text stays unchanged, but the request counts against your quota. Rejected clicks, for example because of a text that is too long or an exhausted quota, do not count. If the provider fails, answers with a server error, is overloaded, unreachable or too slow, the request does not count against your monthly quota. The daily limit still counts it. HocDoc refunds at most 3 such requests per workspace and day. Refusals and the provider's rate limit (429) keep counting.

## Messages

| Message | What to do |
| - | - |
| Your plan does not include AI features. | The writing assistant is part of Pro and Team. |
| The request was invalid. Please reload the page. | Reload the page. |
| The provider did not respond in time. Your text is unchanged. / The provider is not reachable right now. | Try again later. |
| The provider declined the request. / The provider's answer was not usable. | Try again or change the text yourself. |
| The suggestion is longer than the field allows (at most … characters) and was discarded. | Shorten first or change the text yourself. |
| The suggestion is not shorter than your text and was discarded. | Shorten again or change the text yourself. The call counts against your quota. |
| This workspace has reached its daily limit of … text suggestions. / You have reached your daily limit of … text suggestions, counted across all your workspaces. | Continue the next day. |

## Next

* [Create an offer](https://docs.hocdoc.com/en/guides/create-an-offer.md) describes the builder.
* [Language per offer](https://docs.hocdoc.com/en/guides/language-per-offer.md) explains why translating a text does not change the offer's language.


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