Postman FlowsBuild flowsAnalyze

Visualize data in Postman Flows

View as Markdown

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

Output block

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.

Visualization types

The Display block supports the following types of output:

TextDisplays incoming information as text.Text example
NumberDisplays an integer if the information connected to the input is a number.Number example
BooleanDisplays 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 & TimeIf 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
JSONShows the information connected to the input in JSON format, enabling you to view and select data.JSON example
Bar ChartShows one or more sets of information connected to the input.Bar chart example
Line ChartShows a line for X and Y coordinates connected to the input.Line chart example
GaugeShows a number when the input is a percentage.Gauge example
TableShows the connected input as a table with rows and columns.Table example
MarkdownShows the text with all of the Markdown annotations displayed.Markdown example
HTMLAccepts valid HTML and renders it as formatted HTML.HTML example
URLShows a hyperlink to the URL that’s connected to the input.URL example
ImageShows an image from a URL that’s connected to the input.Image example
VideoShows a video from a URL that’s connected to the input and enables it to be played.Video example
YouTubeShows 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 Setting icon 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 icon Add input. Enter “List 1” for the first input, then add another input and enter “List 2”. Change both inputs to List icon List.
  2. In the right sidebar, select Scenarios 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 icon 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, click Setting icon Additional Settings in the Display block.