Step-by-step example of how to create an outcome measure - GAD-7
This example guide will walk through how to create a GAD-7 outcome measure.
It will cover:
-
creating a new group for outcome measures
-
creating a GAD-7 Total Score trackable measures
-
creating a form that contains the GAD-7 questions with a numeric score attributed to each choice for each question
-
adding the GAD-7 Total Score trackable measure to the form template, containing a calculation which automatically adds up the total score for the GAD-7
1. When creating an outcome measure, the first step is to identify the form to be recreated, and the actual outcome(s) that should be tracked. In this example, this is the GAD-7, following this linked template.
Users will need to be a site administrator to create a trackable outcome measure
2. Open the main WriteUpp menu and choose Fields -> Outcome Measures
3. If you don't already have any groups set up, click on Add Group:

Groups provide a way to categorise your outcome measures once they've been completed for a patient. You can view either all outcome measures or pick a group to view. For example, if you use a variety of tools from the same organisation, you might want to group them together.
3. Once you have a Group to use, click on +Add to create the measure that you want to track.
4. Identify what you want to be able to track based on the form you intend to build. Based on the GAD-7, the trackable measure is the Total Score.
5. When adding an outcome measure:
- Name - Enter the name of the outcome measure you are tracking
- Group - Choose the group it should be contained in (see above!)
- Description - Enter a brief optional description
- Unit (optional) - If you'd like to associate a unit of measurement to the outcome, you can do that here.
- Minimum and Maximum values - What is the expected range of the score? The GAD-7 is scored by assigning values from 0 to 3 to 7 items, and then taking the sum of the items, so the range entered is minimum = 0 and maximum = 21. Entering the min and max values here helps to ensure the calculated score is correct, and that the chart on a client record displays the correct range.
Then Save:

6. Next, a form template needs to be built to contain the questions and the outcome measure calculation. Head to Settings -> Assessments and choose Create Assessment Form.
Again, you need to be a Site Administrator to create form templates
7. When building new forms in WriteUpp, there are a couple of tools available to help you.
- Tools -> Form import. This allows you to import forms into WriteUpp from either PDF or image files. This will create the best possible version of your form, in the WriteUpp format. It's not guaranteed to be perfect each time but it should save time vs creating forms manually.
- Form Builder -> AI assistant. When working in the form builder, you can use the AI assistant to either help edit an existing form, or recreate a single form at a time. This is still a beta service but is a great starting position for creating new forms, and helpful for making changes if you've imported a form and need to make some tweaks.

8. A guide to starting with the form builder can be found here, if you need any help getting to grips with the different field types and formats available.
9. When creating forms to use as outcome measures, the questions that result in the score you'd like to track should be created using the Numeric field:

10. For example, the Total Score of the GAD-7 is calculated from the sum of 7 answers. When adding all 7 of those questions to the form, choose Numeric from the available field types.
11. When adding a numeric field:
- Field name - Enter the question to be asked, for example "1 Nervous, anxious or on edge"
- Mandatory - Choose whether it should be mandatory
- Number format -
- Whole numbers: Will accept whole number eg 1, 2, 3
- Decimals: Will accept a number to 2 decimal places eg 2.35
- Attached outcome measure - If the field is to be used to track one of your outcome measures, choose it here. When adding the questions to be answered, an outcome measure does not need to be attached. In this example question, an outcome measure does not need to be attached.
- Value input -
- Number field: Will allow a number to be entered as a whole number or a decimal, based on the above number format
- Single choice with numeric score: Will allow single choice text options to be entered, each with a corresponding numeric score. For example, the GAD-7 questions are presented with labels ranging from Not at all to Nearly every day, which have a corresponding value of between 0 and 3.
Not at all - 0
Several days - 1
More than half the days - 2
Nearly every day - 3
Using this field type, the questions can be presented as a single choice, with an assigned score which is used in the calculations.
- Field layout - Choose whether to display single choice fields horizontally or vertically. A matter of personal preference!
12. Repeat the steps to add each question to the form, and to format it correctly. Remember when building a form, you can switch to Preview at the top of the screen to see how it will look when completing it.
13. Once all the questions are in place, Numeric fields can then be added to the form to calculate and capture the outcome measure set up in Step 5.
14. For the GAD-7, add a Numeric field to calculate the sum of the 7 questions on the form. To add an outcome measure field with a calculation:
- Field Type - Numeric
- Field Name - The outcome measure being tracked eg Total Score
- Mandatory - Is the score mandatory? It's a good idea to make questions that you're going to use in calculations mandatory, as excluding them could skew your results if no value is found.
- Number format - Do you expect a whole number or a number to 2 decimals places. For example, when calculating an average, a decimal number is probably more likely
- Attached outcome measure - What measure does this field calculate? In this example, Gad-7 Total Score.
- Value input - To be able to use a calculation for an outcome measure, leave the value input as Number field
- Calculation - How is the score to be calculated? Calculations use the Field names entered on your form. As the example shows, you might enter (@Field 1 + @Field 2)/Field 3.

15. To enter a calculation, use @ in the calculation field to show a list of the field options to select from:

Then use these values to build the complete calculation.
In the GAD-7, the Total Sore is calculated from the sum of fields 1, 2, 3, 4, 5, 6, and 7.
Therefore the calculation entered is:
@1 Feeling nervous, anxious or on edge + @2 Not being able to stop or control worrying + @3 Worrying too much about different things + @4 Trouble relaxing + @5 Being so restless that it is hard to sit still + @6 Becoming easily annoyed or irritable + @7 Feeling afraid as if something awful might happen

Which then looks like this:

16. The form now contains all the questions that need to be asked, and the fields and calculations to result in trackable outcome measures once used with a client.
17. Make sure to hit Finish editing when you complete a field, and Publish and Exit before leaving a form, so you can see it and use it with your clients.
18. To complete a form containing outcome measures with a client, go to Create -> Form/Assessment and search for or find it on the list.
19. Numeric fields that are linked to outcome measures eg the GAD-7 Total Score created and added above, are not editable when completing a form:

but as the questions are completed, will populate as your calculations define:

20. Once forms are saved, the Outcome Measures tab of the client summary can be used to view results plotted on a graph or in a table. If the form is repeated at a later date, new points will be plotted against the new date, allowing progress to be easily viewed over time.
21. Figures can also be manually added, including historic data, so if you have the results of the same questionnaire in another format eg on paper, click on Add Value at the bottom right.

22. We hope this helps. Happy measuring and please get in touch with support if you have any questions we can help with!