---
title: Creating a document in the Word editor
description: Automate document creation by uploading .docx files, inserting variables, applying rules, and connecting to DocuSign for seamless signing.
---

[Skip to content](https://help.joseflegal.com/creating-a-document-in-the-word-editor#main-content)

<https://help.joseflegal.com/kb-tickets/new?hsLang=en>

[![Josef Logo](https://help.joseflegal.com/hs-fs/hubfs/josef-logo-4.png?width=120&height=40&name=josef-logo-4.png)](https://www.joseflegal.com)

Open main navigation

Close main navigation

- <https://help.joseflegal.com/kb-tickets/new>
- [Contact us](https://help.joseflegal.com/kb-tickets/new)

[Contact us](https://help.joseflegal.com/kb-tickets/new?hsLang=en)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Support](https://help.joseflegal.com/?hsLang=en)
2. [Josef No-Code Automation Platform](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en)
3. [Document creation](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#document-creation)

# Creating a document in the Word editor

<iframe height="315" src="https://www.youtube-nocookie.com/embed/6O1E8zsMxPM" style="margin:" 10px auto; display: block; clear: both; width="560" allowfullscreen></iframe>

 

After you have [**created a new document message**](https://help.joseflegal.com/creating-a-new-document?hsLang=en), you can upload an existing **.docx** file to create your automated document. We’ve broken down this process into a few key steps. 

1. [**Upload your document**](https://help.joseflegal.com/creating-a-document-in-the-word-editor#upload-your-document)
2. [**Insert variables**](https://help.joseflegal.com/creating-a-document-in-the-word-editor#insert-variables) 
     - [Inserting file uploads](https://help.joseflegal.com/creating-a-document-in-the-word-editor#inserting-file-uploads)
3. [**Applying rules**](https://help.joseflegal.com/creating-a-document-in-the-word-editor#applying-rules) 
     - [Select the text you wish to automate](https://help.joseflegal.com/creating-a-document-in-the-word-editor#select-text-to-automate)
     - [Apply rules](https://help.joseflegal.com/creating-a-document-in-the-word-editor#apply-rules)
4. [**Edit content in-app via the Word editor**](https://help.joseflegal.com/creating-a-document-in-the-word-editor#edit-content-in-app-via-the-word-editor)
5. [**Edit content in Microsoft Word via Export**](https://help.joseflegal.com/creating-a-document-in-the-word-editor#edit-content-in-word-via-export)
6. [**Change your document name (optional)**](https://help.joseflegal.com/creating-a-document-in-the-word-editor#change-your-document-name)
7. [**Test your document**](https://help.joseflegal.com/creating-a-document-in-the-word-editor#test-your-document) 
     - [Via Export](https://help.joseflegal.com/creating-a-document-in-the-word-editor#test-your-document-via-export)
     - [Via Preview](https://help.joseflegal.com/creating-a-document-in-the-word-editor#test-your-document-via-preview)
     - [Via Launch](https://help.joseflegal.com/creating-a-document-in-the-word-editor#test-your-document-via-launch)
8. [**Set document expiry (optional)**](https://help.joseflegal.com/creating-a-document-in-the-word-editor#set-document-expiry)
9. [**Connect to DocuSign (optional)**](https://help.joseflegal.com/creating-a-document-in-the-word-editor#connect-to-docusign)

### **1. Upload your document**

You must upload a **.docx** file that is less than 10MB. 

You can drag and drop your file into the **Upload document** pop-up, or use the Choose file button to select from your local files. Once the upload is complete, select the purple Edit document button. A new tab will then open with the Word editor.

Your uploaded document will appear as editable blocks of text in the Word editor. Your styling is saved, but only certain elements appear in the Word editor.

- **Note:** Before you upload your document, please ensure it is a **.docx** file, not a **.doc** (Microsoft Word 97 - 2004 document) file type. Any older Microsoft Word file types need to be converted into **.docx** files before uploading them to Josef.

### **2. Insert variables**

To insert a variable into your document, place the cursor where you want the user response (i.e. the variable) to appear. Next, click Insert response in the purple toolbar.

Select the relevant message name, click Insert, and it will then appear in your document in purple text.

Only variables connected to your bot's conversation flow can be inserted into your document. 

#### **Inserting file uploads**

When you select a file upload variable to insert into your document, you can choose whether to display the file as a link or an attachment.

Image files (limited to **.png** and **.jpg**) uploaded by a user can be displayed as either links or as embedded images positioned inline within your document.

Document files (limited to **.docx**) can also be displayed as links, or attached to your document as an appendix. 

To attach a document as an appendix, simply insert the variable at the end of your document. A .docx file uploaded by your users that is inserted as an attachment will be appended to the end of your document. 

All other file types will be displayed as links in your document.

### **3. Applying rules**

Rules determine whether blocks or lines of text appear in your bot's generated document. 

In this section, we'll outline how to:

- Select the text you wish to automate via rules
- Apply rules
- Apply the All/Any toggle
- Edit and delete rules

#### **Select the text you wish to automate**

You can do this by selecting individual characters or words, or by selecting entire blocks.

1. To select Individual characters or words, highlight the text and select **Add rule** in the top toolbar.
2. To select entire blocks (denoted by their pale purple border), click on the block and select **Add block rule** button in the top toolbar. The border will turn dark purple once selected.

To apply the same rule(s) to multiple blocks, highlight them all at once and follow the same step as above.

#### **Apply rules**

Once you have selected the block or text,

1. Click the **Add rule** button in the purple toolbar. A purple sidebar will appear.
2. Press **Add rule** to determine when the text will appear.
3. Input the relevant automations: 
     - Variable
     - Operation
     - Value

**Example**

If a user expresses that the term of an agreement is greater than two years, the related clause in the document would contain the following rules.

- **Variable** (i.e. the Message name): Term in years
- **Operation**: is greater than
- **Value**: 2

When you’re done, click out of the sidebar. It'll save automatically!

The rule will be highlighted in blue once the rule has been applied. To edit, click the text/block and select **Edit text/block rule** in the top toolbar. 

#### **Applying multiple rules**

You can add as many rules as you like to the text. To do this, just click the **Add rule** button again. If you do create more than one rule in the same connection, you will need to be aware of how the All/Any toggle works (see below).

- **Note:** Ensure you're using the correct Operation with each new rule added.

#### **Applying rule groups**

You can also apply rule groups where two or more rules need to be satisfied for the logic to be applied.

To do so, after creating a rule, select **Add group** rather than Add rule in the sidebar. The group will expand and you will be able to add the rules that you would like to be met, in the same way as detailed above. Be mindful of the All/Any toggle!

For ease of reference, you can rename your group. Simply click on the name of the group rule in the top left of the sidebar (e.g. Group 1)  to edit the text.

#### **Apply the All/Any toggle**

The All/Any toggle appears at the top of the rules sidebar.

If you have created more than one rule and you select **Any**, the related text/block will appear if any of those rules are met. 

By selecting **All**, all rules will need to be met in order for the related text/block to appear in your document.  

It’s like using “And” or “Or” in a Boolean search when you’re doing legal research.

#### **Edit and delete rules**

Click on the text highlighted in blue. Select **Edit text/block rule** in the top toolbar. Here you can edit, add or delete rules, if necessary.

**Note:** Text with rules applied can also be edited. Simply click on the text in your document and type as you normally would. Navigate your mouse elsewhere once complete.

 

### **4. Edit content in-app via the Word editor**

Once you have uploaded your document, there are two ways you can edit it.

1. Within the Josef Word editor
2. By [exporting the document](https://help.joseflegal.com/creating-a-document-in-the-word-editor#edit-content-in-word-via-export) and making changes within Microsoft Word

Here's an overview of what's possible in the Word editor. 

 

**Add text**

Navigate to the relevant block and type in the new text. 

 

**Delete or duplicate blocks**

Select the block and click either duplicate or delete via the floating toolbar on the left. 

 

**Re-order blocks**

To re-order text blocks:

1. Select the block
2. Press the up or down icons in the floating toolbar on the left

 

**Text formats**

Use the formatting toolbar in the top-right, you can embolden, underline or italicise sections of text. The usual keyboard shortcuts (e.g. Ctrl + B) are also options.

 

**Format painter tool**

To copy the formatting (e.g. font size, colour, etc.) of one block onto another, use the Format painter tool. 

1. Click on the block with the pre-existing formatting
2. Click on the Format painter tool in the top-left
3. Click on the block you wish to apply the formatting onto. Done!

 

**Looping**

If you've used looping logic in your bot, you can insert looped variables into your document. [Learn how](https://help.joseflegal.com/looping-logic?hsLang=en).

 

**Unsupported content**

Certain types of content (e.g. cross-references & images, etc) do not display in the Word editor or are uneditable. We call this unsupported content that instead displays as grey, locked blocks.

While such content does not display as expected in the Josef Word editor, it displays normally in your bot's final generated document.

**To learn more about how to edit this content, check out [this article](https://help.joseflegal.com/unlocking-unsupported-content-and-blocks?hsLang=en).** 

 

### **5. Edit content in Microsoft Word via Export**

If you want to make substantial formatting changes to your document, we recommend

1. Exporting your document
2. Making any edits in Microsoft Word
3. Re-uploading the document to Josef

**The re-uploaded document will retain any previously applied rules, variables and loops. No need to re-automate!**

**[Learn how](https://help.joseflegal.com/export-re-upload-documents-beta?hsLang=en) to export & re-upload documents.**

### **6. Change your document name (optional)**

![4655523020175](https://help.joseflegal.com/hs-fs/hubfs/Knowledge%20Base%20Import/4655523020175.gif?width=360&height=90&name=4655523020175.gif)

\[**GIF**: A document title being renamed in the top Word editor toolbar\]

Once you have uploaded your document to the Word editor, you can change the document name by navigating to the top left and clicking on the title. 

Once clicked, a highlighted text field will appear. Here you can insert a new title and hit enter on your keyboard to confirm.

The document name can be changed however many times you like.

### **7. Test your document**

Builders can test their documents in a few ways.

1. [Via Export](https://help.joseflegal.com/creating-a-document-in-the-word-editor#test-your-document-via-export)
2. [Via Preview](https://help.joseflegal.com/creating-a-document-in-the-word-editor#test-your-document-via-preview)
3. [Via Launch](https://help.joseflegal.com/creating-a-document-in-the-word-editor#test-your-document-via-launch)

If you'd like to make any changes to your document upon testing, please see steps 4 and 5 for guidance. Otherwise, here are a few other ways to test.

#### **Via Export**

This is suited for making format edits (as per step 5), or if you want to see how and where variables, loops & rules are placed in your document. 

Prior to launch, switch the toggle in the top right of the Word editor to either MS Word or PDF.

In the comment section of Word exports, you'll find all the variables & rules applied to your document. 

PDF exports do not include such comments, however, they do feature the variables populating your document.

#### **Via Preview**

If your document is located in an [External document](https://help.joseflegal.com/message-types?hsLang=en) message, you can test how it generates via Preview. Here's how.

1. Navigate back to the bot's building environment
2. Select Preview in the bottom left-hand corner
3. Interact with your bot
4. Download your document via the bot UI

#### **Via Launch**

Any documents located in [Internal document](https://help.joseflegal.com/message-types?hsLang=en) messages can be tested by temporarily launching your bot. This will involve interacting with the bot and then downloading the document from the [Activity tab](https://help.joseflegal.com/reporting-and-records?hsLang=en). 

- **Note:** Ensure any sensitive [Notifications](https://help.joseflegal.com/send-notification-emails?hsLang=en) have been switched off prior to testing! This method involves interacting with the live version of your bot, so be careful.

### **8. Set document expiry (optional)**

Builders can also set an expiry period for generated document links. 

To apply this to a document, 

1. Open the relevant document message via either List view or Flowchart.
2. Click **Edit document** in the Edit message sidebar to open the document in the Word editor.
3. Click **Settings** in the top right.
4. Under **Document access**, switch the toggle on.

![7735514881423](https://help.joseflegal.com/hs-fs/hubfs/Knowledge%20Base%20Import/7735514881423.gif?width=412&height=124&name=7735514881423.gif)

\[**Image**: Builder enabling **Expires after 45 days**\]

 

Once enabled, all links generated for the document will expire 45 days after the document is downloaded the first time. It will also apply to previously downloaded documents within the bot.

This feature is only available for documents generated using our Word editor.

### **9. Connect to DocuSign (optional)**

Josef's DocuSign integration allows builders to automate the signing of documents. 

Builders can 

- Automatically send DocuSign envelopes directly to recipients
- Add signature blocks, date stamps and initial blocks
- Pre-configure the required number of recipients

[**Learn more**](https://help.joseflegal.com/docusign?hsLang=en).

 

–

Got a question? Contact us at [support@joseflegal.com](mailto:support@joseflegal.com).

- [Josef Q](https://help.joseflegal.com/josef-q?hsLang=en#main-content)

    - [Using tools](https://help.joseflegal.com/josef-q?hsLang=en#using-tools)
    - [Training tools](https://help.joseflegal.com/josef-q?hsLang=en#training-tools)
    - [Preparing a knowledge base](https://help.joseflegal.com/josef-q?hsLang=en#preparing-a-knowledge-base)
    - [Release note (Josef Q)](https://help.joseflegal.com/josef-q?hsLang=en#release-note-josef-q)
    - [Creating tools](https://help.joseflegal.com/josef-q?hsLang=en#creating-tools)
    - [Managing tools and accounts](https://help.joseflegal.com/josef-q?hsLang=en#managing-tools-and-accounts)
    - [Integrations](https://help.joseflegal.com/josef-q?hsLang=en#integrations)
    - [Resources](https://help.joseflegal.com/josef-q?hsLang=en#resources)
    - [Monitoring & maintaining tools](https://help.joseflegal.com/josef-q?hsLang=en#monitoring-maintaining-tools)
- [Josef No-Code Automation Platform](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#main-content)

    - [Building bots](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#building-bots)
    - [Integrations](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#integrations)
    - [Notifications and workflows](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#notifications-and-workflows)
    - [Document creation](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#document-creation)
    - [Managing bots](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#managing-bots)
    - [Testing, troubleshooting and editing](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#testing-troubleshooting-and-editing)
    - [Launching](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#launching)
    - [Single Sign-On](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#single-sign-on)
    - [FAQs](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#faqs)
    - [Getting started on Josef no-code](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#getting-started-on-josef-no-code)
    - [Release notes & FAQs for Josef no-code](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#release-notes-faqs-for-josef-no-code)
    - [Managing accounts](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#managing-accounts)
    - [Reporting](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#reporting)
    - [Formatting a bot](https://help.joseflegal.com/josef-no-code-automation-platform?hsLang=en#formatting-a-bot)

[![Chill listening crop-3](https://help.joseflegal.com/hs-fs/hubfs/Josef%20logo.png?width=72&height=24&name=Josef%20logo.png "Chill listening crop-3")](http://joseflegal.com)

[support@joseflegal.com](mailto:support@joseflegal.com) 

<https://twitter.com/joseflegal/> <https://www.linkedin.com/company/joseflegal/> [mailto:support@joseflegal.com](mailto:support@joseflegal.com)

Copyright © 2025, Josef Legal