Visualize data in Postman Flows

The Display block accepts information from other blocks and creates a visualization of that information. You can select from several visualization types.

This image shows four types of output visualization types: line chart, text, gauge, and Boolean. You can find links to example flows for other visualization types in the Visualization types section.

For examples of how to use Display blocks in your flows, see the Stock Dashboard and WordPress Sentiment Analysis flows.

Visualization types

The Display block supports the following types of output:

Text	Displays incoming information as text.	Text example
Number	Displays an integer if the information connected to the input is a number.	Number example
Boolean	Displays a true or false value. If the value connected to the input isn't true/false or 0/1, it always displays true.	Boolean example
Date & Time	If the incoming text or number can be interpreted as a date, it displays in DD MMM, YYYY HH:MM:SS am/pm format.	Date & Time example
JSON	Shows the information connected to the input in JSON format, enabling you to view and select data.	JSON example
Bar Chart	Shows one or more sets of information connected to the input.	Bar chart example
Line Chart	Shows a line for X and Y coordinates connected to the input.	Line chart example
Gauge	Shows a number when the input is a percentage.	Gauge example
Table	Shows the connected input as a table with rows and columns.	Table example
Markdown	Shows the text with all of the Markdown annotations displayed.	Markdown example
HTML	Accepts valid HTML and renders it as formatted HTML.	HTML example
URL	Shows a hyperlink to the URL that's connected to the input.	URL example
Image	Shows an image from a URL that's connected to the input.	Image example
Video	Shows a video from a URL that's connected to the input and enables it to be played.	Video example
YouTube	Shows a YouTube video from a URL that's connected to the input and enables it to be played.	YouTube example

Text

When a Display block receives a string, it automatically selects the Text visualization type and shows the text.

To create an example text Display block, do the following:

1. Create an HTTP Request block with a GET request to postman-echo.com/get.

2. Create and connect a Select block to the HTTP Request block and enter body.headers.host. This selects a string from the response.

3. Create a Display > Text block, then connect the Select block to the Display block.

   To adjust the text size, select the Display block, then click Additional Settings > Text size.

4. Click Run in the Flows toolbar. The Display block displays the postman-echo.com string from the body.headers.host response.

   

Boolean

When a Display block receives a message that's either true or false, it automatically selects the Boolean visualization type, displaying True or False.

To create an example Boolean Display block, do the following:

1. Create an HTTP Request block with a GET request to postman-echo.com/get.

2. Create and connect an Evaluate > FQL block to the HTTP Request block and enter the value1.http.status = 200 FQL query. This query checks if the response returns a 200 status code.

3. Create and connect a Display > Boolean block to the Evaluate block and run the flow. If the response has a 200 status code, the Display block shows a circle that says True. If not, the circle shows False.

   

Line chart

The Line Chart visualization type accepts two lists and plots them on X and Y axes in a chart. The first list received is the X axis, and the second list is the Y axis.

To create an example line chart Display block, do the following:

1. In the Start block, click Add input. Enter "List 1" for the first input, then add another input and enter "List 2". Change both inputs to List.

2. In the right sidebar, select Scenarios > Create scenario.

3. Enter [10, 20, 30, 40, 50, 60, 70] for List 1's data and [100, 200, 300, 400] for List 2's data. Click Save.

4. Create a Display > Line Chart block, then connect the List 1 and List 2 inputs in the Start block to the Display block.

5. Click Run in the Flows toolbar. A line chart displays the data on their respective axes.

   

Gauge

The Gauge visualization type shows a value's position in a range using a half-pie chart.

To create an example gauge Display block, do the following:

1. Create an HTTP Request block with a GET request to techcrunch.com/wp-json/wp/v2/posts.

2. Create and connect an Evaluate > FQL block to the HTTP Request block.

3. In the Evaluate block, enter the $count(value1.body) FQL query to count how many items the response body contains.

4. Create a Display > Gauge block. Connect it to the Evaluate block.

5. Connect the Display block to the Evaluate block, then click Run. The gauge shows the number of items in the response body as the shaded part of the graph.

   To set the minimum and maximum values for the gauge, select Additional Settings in the Display block.