An overview on how to review the transcripts from user's test sessions with your prototypes.

Overview of User Testing

As with any other fields of design, understanding and analyzing which components of your conversations frustrate users, where they get confused or stuck, and what keeps them from progressing and/or converting, is crucial in ensuring good Conversation Design and a great user experience.

User testing is the stage in the design process which enables you to share & evaluate your conversation (or prototype) with real users and enables you to create human-centric conversation design.

Voiceflow enables user testing by allowing conversation designers to use your Voiceflow Prototype to test with your users and stakeholders. It is a great way to learn about what works, and doesn't work with your design and functionality.


You can get even more insights on each interaction with your prototype using the Transcripts functionality. You can access the Transcripts section by navigating to the main left panel located next to the sidebar, or using shortcut (2).

Each transcript provides a turn-by-turn record of each user interaction, what utterances they used, and what intents they hit along the way.

It also allows you to collaborate with your team and stakeholders to provide Actions, Tags and Notes to help organize, enable and communicate information, all at the transcript-level.

The goal of the Transcripts is to give you and your team an understanding of where your project was successful in helping your users, and where it can be improved.

Saving a transcript

A transcript can be created from tests run on both the internal Test Tool (on the Creator Tool/Canvas) that you see as a designer, and on external tests run using Sharable Prototype links.

For tests run with the Test Tool, when the test ends, you will be shown an option to Save the test, and you can click that to save a transcript.

For tests run using the Sharable Prototype, each test's transcript will be saved automatically.

Note: When running tests while designing/testing your prototype on the Test Tool on the Creator Tool/Canvas, your tests will NOT save automatically in the Transcripts section, until the test ends and you reach the option to manually Save Test.

Viewing transcripts

Your transcripts can be found in the left-hand navigation, or quickly accessed using the keyboard shortcut 2.

Once in the Transcripts tab, you can click through all available transcripts for your project in the left-hand Conversations List.

Navigating to the top of this list, you will find filters available to allow you to sort, organize & filter all of your available transcripts by date (Time Range) and by Tags.

This information can be added and adjusted at the transcript-level, using the right-hand Actions Menu.

You are also able to configure the type of data you'd like to view in testing such as Debug Messages and Intent confidence data. Using the ... menu above each transcript, you can choose to enable and disable these fields that you'd see in the Test Tool.

Adding utterances to intents

If you have the Intent Confidence set to visible, you will see an option to "Add utterance to intent" on any utterance that did not match an intent during your testing. This is a quick way to use your test transcripts to iterate on your design, and improve your prototype's Training. If you do add an utterance to an intent, it is important to remember to re-train your Assistant before testing again, to ensure it is trained with the new data.

Tagging and commenting

As your team runs multiple tests and the transcripts screen gets filled with different tests, you can organize your transcripts with tags to make it easier for your team to sort through and find the important ones.

In the right-hand Actions Menu, we offer built-in tags such as Mark as Reviewed, Save for Later and sentiment emojis. You can also add your own custom tags by navigating and clicking into the Tags input field.

Any tags you have created can be used to filter your Conversations (Transcripts) list.

In the Add Tags dropdown menu, you can select the Manage Tags option to Delete any tags from your project. You can also delete tags by hitting the X in the respective tag in the tag box.

You are also able to add notes or comments for designers and stakeholders to view in the Notes section under the Tags section.

Downloading and Deleting Transcripts

If you are looking to take your transcripts offline and off-tool or run further analysis on them, you have the option of exporting your transcript(s).

You can select the ... menu in the Conversations (Transcripts) list, located next to each transcripts' title, and click the Export option. This will download a CSV export of your transcript.

To delete irrelevant or undesired transcripts, you can select the Delete option from the ... menu, or from the right-hand Actions menu.

Other docs in this section