--- title: "Admin: Add Note Compose Design" slug: "administrator-help-add-note-compose-design" updated: 2026-06-16T19:14:21Z published: 2026-06-16T19:14:21Z canonical: "support.nvoq.com/administrator-help-add-note-compose-design" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.nvoq.com/llms.txt > Use this file to discover all available pages before exploring further. # Admin: Add Note Compose Design Create new custom Note Compose designs in nVoq Administrator using the Note Compose Designer. ## Create a Design 1. Go to the **Note Compose** page in nVoq Administrator. [](/docs/administrator-help-add-note-compose-design#design-type) - This page is only visible to system-level administrators and administrators with an Administrator Role at the tenant level. 2. Click on the **+ icon in the blue toolbar** to open a menu of ways you can create a design. Select one.![NoteCompose-Designer-new-menu.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/NoteCompose-Designer-new-menu.png) - **Based On Example -** Use an example of a clinical note that you want the formatting to follow. - **Brief Description -** Describe the type of clinical note you want the formatting to follow. - **Manual Input -** This is a free text field where you can create your own formatting design from scratch. 3. The New Note Compose Design page automatically opens on the **Note Compose Design tab**.![NoteCompose-Designer-new-design-NoteComposeDesign-tab.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/NoteCompose-Designer-new-design-NoteComposeDesign-tab.png) 4. Add a **name** for the design. - This is the name that will appear in the nVoq Voice Note Compose drop-down menu. (In order for nVoq Voice to have an Note Compose drop-down menu, clinicians must have to Note Compose for structured notes.) - Your design cannot have the same name as any design in your tenant OR the same name as any design that exists at the system level. If you attempt to create a design with a name that already exists in either of these locations, a red notification will let you know. 5. Optionally, **turn off the Enabled toggle** while you are creating your design. - Enabled designs are displayed in nVoq Voice (if the clinician has Note Compose for structured notes). For that reason you may want to keep your design *disabled* until it is complete and tested to make sure it works as expected. - Enabled designs are also available on the [**Add/Edit Assessment page for Voice Assistant**](/v1/docs/admin-help-assessments). 6. Optionally, add a **description** of your design. - The description is only visible in nVoq Administrator. 7. Add the appropriate information in the text area for the type of design you selected from the menu in Step 2. - **Based On Example -** Enter an example of a clinical note that is already formatted the way you want the design to format a note.![Intelligent Formatting Design-ADD-example.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/image-1740430883829.png) - **Brief Description -** Enter a description of the kind of note you want the design to format (e.g. "Create an MRI report for a cat").![Intelligent Formatting Design-ADD-brief-description.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/Intelligent%20Formatting%20Design-ADD-brief-description.png) - **Manual Input -** Create your own note from scratch in the blank text area. Skip to Step 10. 8. Click the **Convert to Design button** below the text area.![Intelligent Formatting Design-ADD-convert-to-design.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/Intelligent%20Formatting%20Design-ADD-convert-to-design.png) - This button only displays if you are creating a note based on example or description. 9. The Design text area displays the new design. - System-created headers display with a colon after them. You can keep or remove the colon.![Intelligent Formatting Design-ADD-header.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/Intelligent%20Formatting%20Design-ADD-header.png) - Text that appears [between brackets] is where information from the clinical note will be pulled into the formatted note. These are called "placeholders". ![Intelligent Formatting Design-ADD-placeholder.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/Intelligent%20Formatting%20Design-ADD-placeholder.png) - Any text that is not a [between brackets] will be included as-is in the formatted note.![Intelligent Formatting Design-ADD-as-is-text.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/Intelligent%20Formatting%20Design-ADD-as-is-text.png) 10. Make any changes you want to the note. You can use the **Assistant** buttons for more help. - #### Assistant Buttons ![Intelligent Formatting Design-ADD-assistant-button-mapping.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/Intelligent%20Formatting%20Design-ADD-assistant-button-mapping.png) - **Heading -** This button adds a new heading where you have your cursor in the Design field. Replace the word "Heading" with whatever you want the heading to say. You can also just manually type headings. They do not have to be followed by a colon. - **Placeholder -** This button adds open and close brackets [] to indicate where information from the clinical note should be pulled into the design during formatting. Between the brackets add the description of the information from the clinical note should be added there. You can also manually add the brackets. - **Placeholder Instruction -** This button adds instruction *to the artificial intelligence* that can be added to any placeholder, basically telling it to only use text that is included in the clinical note and not to improvise anything. Press the button to add the instruction after a placeholder, outside the placeholder brackets. These instructions appear between parenthesis (). You can put them after as many placeholders as is needed. They do not appear in the final formatted note. - **Final Instruction -**This button adds instruction *to the artificial intelligence* that can be added at the bottom of a design, basically telling it to only use text that is included in the clinical note and not to improvise anything. These instructions are displayed (between parenthesis). If needed, you only need to add one of these to the end of your design. They do not appear in the final formatted note. - Any text added to the design that is not between brackets or parenthesis will be included as-is in the formatted note. ![Intelligent Formatting Design-ADD-free text.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/Intelligent%20Formatting%20Design-ADD-free%20text.png) 11. Click the **Save button** to save your design. A green notification lets you know that your design was saved successfully.![NoteCompose-Designer-new-design-add-success.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/NoteCompose-Designer-new-design-add-success.png) ## Test a Design Try out your design on the Test tab to make sure it works as expected. 1. Click on the **Test tab**.![NoteCompose-Designer-new-design-Test-tab.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/NoteCompose-Designer-new-design-Test-tab.png) 2. Enter an example of a clinical note that should be formatted like your new design into the **Test Text** area.![NoteCompose-Designer-new-design-Test-text.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/NoteCompose-Designer-new-design-Test-text.png) 3. Click the **Run** button.![NoteCompose-Designer-new-design-Test-run.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/NoteCompose-Designer-new-design-Test-run.png) 4. The **formatted note** appears below the Test Text area.![NoteCompose-Designer-new-design-Test-formatted-note.png](https://cdn.us.document360.io/03b5534a-5f9a-42ce-852d-08bf09105da4/Images/Documentation/NoteCompose-Designer-new-design-Test-formatted-note.png) 5. Test multiple example notes by replacing text in the Test Text area and then clicking the Run button again. Consider testing some example notes that are incomplete or irrelevant to see what happens.