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

# Library

> Create services, quotes and objections once, organize them with tags and insert them into offers in the builder.

The library collects building blocks you need in several offers. There are three kinds, each with its own tab on the **Library** page.

| Tab | Content | Lands in the offer as |
| - | - | - |
| **Services** | Packages and add-ons with a price | Package or add-on of the "Pricing" section |
| **Quotes** | Testimonials | Entry of the "References" section |
| **Objections** | Question and answer | Entry of the "FAQ" section |

A workspace can have at most 1000 entries. Entries in the trash do not count. Once the limit is reached, HocDoc reports "The library is full (up to 1000 entries). Delete an entry first."

## Create entries

**1. Choose a tab**

Open the tab for the kind and choose **Add service**, **Add quote** or **Add objection**.

**2. Fill in the fields**

The fields per kind are listed below. The entry's title comes from the content: for a service the name, for a quote person and company, for an objection the question.

**3. Assign tags and save**

Enter **Tags** if needed and choose **Save**. HocDoc reports "Service added.", and correspondingly for quotes and objections.

### Service

* **Name** (required, at most 160 characters) and **Description** (at most 2000 characters).
* **Price** and **Currency**. New services start with the workspace's currency. If you switch the currency, the amount stays as a number (rounded for currencies without decimal places). HocDoc converts nothing.
* **Billing note** (at most 80 characters), for example "one-time".
* **Included items**: up to 30, at most 120 characters each. **Add included item** adds one.

### Quote

* **Quote** (required, at most 2000 characters).
* **Person** (required), **Role** and **Company** (at most 120 characters each).

### Objection

* **Objection (question)** (required, at most 300 characters).
* **Answer** (required, at most 4000 characters).

## Edit and duplicate

Every entry has a menu with **Edit**, **Duplicate** and **Delete**. The kind of an entry cannot be changed.

Duplicating creates a copy in the same workspace. Name, person or question get the suffix " (Copy)", as long as the text still fits the field limit afterwards. The tags are kept.

If the saved content of an entry is invalid, the card shows "The saved content is invalid. You can only delete the entry and create it again."

When you create or rename an entry, HocDoc checks whether an entry with the same title already exists in the same kind. Upper and lower case and whitespace at the edges do not count. Then the dialog says "An entry with this title already exists. You can still save." The note blocks nothing. Entries in the trash do not count. If you save before the note appears in the dialog, it appears in the success message: "Service added. An entry with this title already exists." When renaming, it correspondingly says "Service saved. An entry with this title already exists." (for quotes and objections with the respective kind).

## Favorites

Every card has a star. With it you mark the entry as a favorite, and with a second click you remove the mark. A favorite applies to the whole workspace, not just your account. Your team sees the same favorites.

Favorites appear at the top of the list, followed by the other entries with the most recently changed first. The same order applies in the builder's insert dialog, where a favorite carries the badge "Favorite". When inserting a quote with **Matching**, the number of matching tags counts first. With an equal number, the favorite comes first.

Owners, admins and members can mark favorites. Viewers only see the star as a badge. In the trash the favorite is kept and does not change. Marking counts as a change: a new favorite comes first among the favorites.

## Tags, search and filters

An entry has up to 10 tags of 1 to 40 characters each. Accept a tag with Enter or comma. Tags that differ only in upper and lower case count as one tag.

While you type, the field suggests tags that are already used in your workspace, across all three kinds. At most 8 suggestions appear. Tags that begin with your input come first.

Above the list is the search field with the placeholder "Search". The search finds text in title, tags and the content fields, including the included items. It does not distinguish between upper and lower case. Next to it HocDoc shows how many entries match ("3 entries").

If the current kind has tags, the eight most frequent ones appear below the search field as toggles, with **All** first. You choose one tag at a time. If there are more tags, another field with the placeholder "Find more tags" appears. It suggests the kind's assigned tags as you type. Free text without a match is discarded. A chosen tag that is not among the eight appears as an active toggle at the end. The list shows favorites first, then the most recently changed entries. With **Show more** you load up to 50 more each time. If nothing is found, **Reset filter** helps.

## Insert in the builder

In the builder, select a "Pricing", "References" or "FAQ" section. On the right, in the **Content** area, is **Insert from library**. For "References" the button only exists in the **Quotes** layout.

**1. Find an entry**

The dialog is called, for example, "Insert service from the library". Search for the entry in the field. The dialog shows at most 50 entries. Refine the search to find more.

**2. Insert**

For services you choose **As package** or **As add-on**. For quotes and objections there is **Insert**.

The entry comes into the offer as a copy. Later changes in the library do not affect existing offers.

* The "Pricing" section holds at most four packages. Once they are taken, only **As add-on** works.
* An add-on takes over name, description and price. Billing note and included items are dropped.

### Note for a different currency

If the service has a different currency than the other prices in the offer, the dialog already says "Different currency than the other prices in the offer (EUR)." After inserting, HocDoc points it out once more. It blocks nothing and converts nothing. The comparison only uses the prices of the "Pricing" section.

### Matching quotes via tags

When inserting a quote, the **Matching** area appears as soon as your quotes have tags. Choose up to 10 tags, such as industry and size. The dialog then only shows quotes with at least one of these tags. Those with the most matches come first, with an equal number first favorites, then the most recently changed. Each card names the matches ("2 of 3 tags match"). **Clear selection** resets. The selection is not saved. Without a selection, the dialog shows the quotes as usual.

## Save from the offer to the library

On every package, add-on, testimonial and question there is a bookmark button in the **Content** area, for example "Save package 1 to library". It creates the entry without tags. Afterwards HocDoc reports "… saved to the library." If an entry with this title already exists there, the message adds: "An entry with this title already exists there." The entry is saved anyway. Assign the tags afterwards on the **Library** page. If the entry does not fit the library's limits or a required field is missing, it says "Not saved." with the reason.

## Trash

**Delete** asks for confirmation and moves the entry to the trash ("Service moved to the trash."). Offers you have inserted the entry into stay unchanged.

The **Trash** tab holds the deleted entries of all kinds, the most recently deleted first. Each card shows kind, title, tags and the date: "Deleted on … Will be permanently deleted on …" Entries stay here for 30 days. Permanent deletion runs once a day, so the date named is usually one day after "delete plus 30 days".

* **Restore** brings the entry back. It counts against the limit of 1000 again.
* **Delete permanently** asks for confirmation ("Delete permanently?") and deletes irrevocably.

The trash holds at most 1000 entries. If it is full, HocDoc reports "The trash is full (up to 1000 entries). Permanently delete some entries there first."

With **Empty trash** you delete all entries in the trash in one step. The "Empty trash?" dialog names the number, for example "12 entries will be deleted permanently. Offers you have already inserted entries into stay unchanged." Only the entries the dialog counted are deleted. If someone deletes another entry afterwards, it stays in the trash. Afterwards HocDoc reports, for example, "12 entries deleted permanently." The button only acts in the active workspace.

There is no search or content preview there.

## Roles

| Role | Library |
| - | - |
| Owner, Admin, Member | Create, edit, duplicate, mark as favorite, delete, use and empty the trash, insert in the builder and save |
| Viewer | View, search and filter by tags. No creating, no changing, no trash |

More about roles is under [Team and roles](https://docs.hocdoc.com/en/guides/team-and-roles.md). How sections are built is described under [Sections](https://docs.hocdoc.com/en/guides/sections.md).


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