Admin: Add Intelligent Formatting Design

Prev Next
Anyone with an Administrator Role at the system level has access to this feature in nVoq Administrator, but it must be enabled for tenant level administrators via API.
Eventually this will be offered as a premium feature, but it is not yet ready for a general release and is only available as a preview for customers (for a tenant organization) who would like to test it. If interested, reach out to your Customer Success Manager. 


Create new custom Intelligent Formatting designs in nVoq Administrator using the Intelligent Formatting Designer.

Custom Intelligent Formatting designs are only available in Voice and Mobile Voice if the PREMIUM version of Intelligent Formatting has been purchased.


  1. Go to the Intelligent Formatting page in nVoq Administrator.
    • 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.Intelligent Formatting Design-ADD.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.
    • Empty - This is a free text field where you can create your own formatting design from scratch.

  3. The New Intelligent Formatting Design page automatically opens on the Intelligent Formatting Design tab.Intelligent Formatting Design-INTELLIGENT FORMATTING DESIGN TAB.png

  4. Add a name for the design.
    • This is the name that will appear in the Voice and Mobile Voice Intelligent Formatting drop-down menu. (In order for Voice or Mobile Voice to have an Intelligent Formatting drop-down menu, clinicians must have the PREMIUM version of Intelligent Formatting.)
    • 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 Voice and Mobile Voice (if the clinician has the premium version of Intelligent Formatting). For that reason you may want to keep your design disabled until it is complete and tested to make sure it works as expected.

  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
    • 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
    • Empty - Create your own note from scratch in the empty 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
    • 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
    • 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
    • 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



  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
      • 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
  11. Try out your design on the Test tab to make sure it works as expected. 
    1. Click on the Test tab.Intelligent Formatting Design-TEST-click-tab.png
    2. Enter an example of a clinical note that should be formatted like your new design into the Test Text area.Intelligent Formatting Design-TEST-test-text-2.png
    3. Click the Run button.Intelligent Formatting Design-TEST-run-2.png
    4. The formatted note appears below the Test Text area.Intelligent Formatting Design-TEST-formatted-note-2.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. 

  12. Click the Save button to save your design. A green notification lets you know that your design was saved successfully.Intelligent Formatting Design-ADD-success.png