Using ShadowScribe Document Template Section Action Options

This article explains the purpose of section action commands and how to use them.

Section Action Options

Section action options are found under the “Edit Section Options” when editing a ShadowScribe template. For more information on editing a ShadowScribe template click HERE.

Section action options only apply to required sections and are typically used in conjunction with some type of canned text or bracketed fields.

Section action options control the recognition behavior of a particular section during the merge process, when the raw draft is combined with the ShadowScribe template.

For example, in the screenshot below, a ShadowScribe template has a Review of Systems section which has the canned text “All systems reviewed and were negative”.  The Action is set to replace, meaning if the clinician speaks this section, and it’s recognized, the recognized text will overwrite the canned text in the draft.


In both Preferred Transcription Format (PTF) examples below the canned text in the screenshot above was replaced by the dictated recognized text.

Structured Example


Unstructured Example


The default action is “Replace” but other actions such as “Prepend” and “Append” are available as well.


This example below shows the “Prepend” and “Append” behaviors on a PTF structured document. A PTF unstructured would exhibit the same behavior.


Section Action Option Usage

Some Common uses for the “Prepend”, “Append”, and “Replace”.

1)      Prepend – use this action when the recognized text needs to appear BEFORE the canned text.

2)      Append – use this action when the recognized text needs to appear AFTER the canned text.

3)      Replace – use this action when the recognized text needs to OVERWRITE the canned text.

One common scenario for the Prepend and Append is when the section has some bracketed fill in the blank fields, where the clinician only speaks the information for the blanks.

In this example, you would want to set the action to “Prepend” to place the recognized text first because the clinician will be dictating “right or left” first.