> For the complete documentation index, see [llms.txt](https://help.clausebuddy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.clausebuddy.com/quality-library/how/in-depth/using-clauses/inserting-clauses.md).

# Inserting clauses

{% embed url="<https://www.youtube.com/watch?v=QA4cOV0Fv7A>" %}

Once you have found a clause, you can insert it into your Word document (i.e. the left side of your Word window), by clicking on the **+** button.&#x20;

## Tweaking a clause before insertion <a href="#tweaking_a_clause_before_insertion" id="tweaking_a_clause_before_insertion"></a>

When you click on the big plus-icon (+) in the left corner of a clause, a dialog box appears where you can configure this clause's content and appearance.&#x20;

<figure><img src="https://2189520742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRnUl2jsv556oF2ZexdO%2Fuploads%2FkVhUcBPQ33dRlFbVzPp8%2FScreenshot%202025-11-27%20at%2016.33.21.png?alt=media&amp;token=32acfd17-3a02-4f34-ab27-73940fbf9163" alt="" width="563"><figcaption></figcaption></figure>

After inserting, a new menu will appear, giving you the option to change the levels of the clause as well as the option of including the clause title or not.

<figure><img src="https://2189520742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRnUl2jsv556oF2ZexdO%2Fuploads%2Fl9xBgz9WPpkpJpBrzkIq%2FScreenshot%202025-11-27%20at%2017.03.37.png?alt=media&amp;token=49cae873-cdea-4364-8dcc-5fb44b401ff8" alt="" width="225"><figcaption></figcaption></figure>

## Filling placeholders <a href="#filling_placeholders" id="filling_placeholders"></a>

ClauseBuddy allows you to fill placeholders — i.e. text marked as yellow in ClauseBuddy's editor — right from within ClauseBuddy, before you insert the clause into your MS Word document. Simply click on the relevant placeholder, and fill in the value you want.&#x20;

<figure><img src="https://2189520742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRnUl2jsv556oF2ZexdO%2Fuploads%2FWITvIKUTO7VuMlY3P6VR%2Fimage.png?alt=media&amp;token=80a37ece-7d02-418e-8437-501fb1f63ee3" alt="" width="563"><figcaption></figcaption></figure>

## Formatting <a href="#tweaking_formatting" id="tweaking_formatting"></a>

ClauseBuddy allows you to easily store clauses together with their internal structure — title, headings, subheadings and bullets — and can ensure that such internal structure is respected when clauses are pasted into an MS Word document.

ClauseBuddy incorporates "**layout-awareness**", which means that ClauseBuddy will do a lot of complex calculations under-the-hood to figure out the styling of your currently opened Word-document, and tries to make your clause fit in there, without you having to do anything.

## Tips <a href="#tips" id="tips"></a>

* When you insert your clause, you may see your screen quickly flash and restructure the text at the left side. The reason is that ClauseBuddy inserts an initially numbered clause, and subsequently tries to fit the numbering and styling to the surrounding clauses. Thanks to this two-step process, you can always try to hit **undo (Ctrl-Z) once in MS Word** to check whether you actually want to keep the initially inserted version. Hit undo again to remove the clause alltogether.


---

# 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://help.clausebuddy.com/quality-library/how/in-depth/using-clauses/inserting-clauses.md?ask=<question>&goal=<user_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.
