elispostman.github.io Open in urlscan Pro
2606:50c0:8003::153  Public Scan

Submitted URL: http://elispostman.github.io/docs/v5/postman/launching_postman/navigating_postman
Effective URL: https://elispostman.github.io/docs/v5/postman/launching_postman/navigating_postman
Submission: On May 18 via manual from GB — Scanned from GB

Form analysis 0 forms found in the DOM

Text Content

Docs Version 5.x Docs Version 6.x
 * PRODUCT
 * SOLUTIONS
    * Publishers
      Onboard developers to your API
    * DevOps
      High Velocity DevOps with Postman
    * QA
      Postman for QA Teams
    * Front-end
      Postman for Front-end Developers & Teams
    * Back-end
      Postman for Back-end Developers & Teams

 * ENTERPRISE
 * PLANS & PRICING
 * DOCS
 * API NETWORK
 * SIGN IN
 * DASHBOARD


NAVIGATING POSTMAN

Postman provides a multi-window and multi-tab interface for you to work on APIs.

This interface design gives you as much space as possible for your APIs.




SIDEBAR

The Postman sidebar lets you find and manage requests and collections. The
sidebar has two main tabs: History and Collections.

You can drag the right edge to resize the width of the sidebar. You can also
minimize the sidebar for smaller screens, and show or hide the sidebar in the
Status bar.


HISTORY TAB

The Postman app saves every request you send in the History tab in the sidebar.


COLLECTIONS TAB

This tab creates and manages collections from the Collections tab in the
sidebar.

Learn more about collections and how they accelerate the speed of your APIs.


HEADER TOOLBAR



The header toolbar contains these options:

 * New button: Creates requests, collections, environments, documentation, mock
   servers, and monitors.
 * Import button - Imports Postman collections, environments, WADL, Swagger,
   RAML, or cURL into Postman using files, links, or raw text.
 * Runner button - Opens the collection runner.
 * New window icon - Opens a new “Tab”, “Postman Window” or a “Runner Window”.
 * Workspaces menu - Opens the Workspaces menu where you can view personal and
   team Workspaces, and create and manage Workspaces.
 * Interceptor/Proxy icon - Manages proxy or Interceptor settings.
 * IN SYNC status icon - Updates the status of your Postman account.
 * Public API Library - Displays the Public API network.
 * Settings icon - Manages Postman app settings and finds other support
   resources.
 * Notifications icon - Receives notifications or broadcasts.
 * Heart - Love Postman? Click on this button to share the love!
 * User dropdown - Displays current user and provides these options: “Profile”,
   “Account Settings”, “Notification Preferences”, “Active Sessions”, and “Add a
   new account”.


CONSOLE

Two consoles are available in Postman to see what’s going on behind the scenes.

 * Postman console - Contains a running log of HTTP requests and responses. You
   can log messages from scripts. For example you could log messages in the
   console.log.
   Note: This feature is only available in Postman’s native apps.
 * DevTools console - Provides diagnostic information during development. To
   learn how to access DevTools console logs, see Debugging and logs.

Learn more about troubleshooting with console logs.


STATUS BAR

The status bar at the bottom of the Postman interface gives you a convenient way
to:

 * Show or hide the sidebar.
 * Search in collections, environments, and globals.
 * Open the Postman console.
 * Select either a single or two pane layout.
 * Open the keyboard shortcuts.
 * Get help or provide feedback.



When you click the Help & Feedback icon, you can summon a menu that provides
access to the latest release notes, documentation, security, support, and social
media.




TABS AND WINDOWS

Postman lets you use multi-tab and multi-window configurations to work on
multiple requests or even multiple collections together and simultaneously.

To open a new tab in Postman, press the + icon in the builder or use
the CMD/CTRL + T shortcut. From the menu bar, you can also select “New Tab” from
the File menu to create a new tab.

When you right click a tab name, the menu allows you to duplicate or close tabs.
 If any tab has unsaved changes as you attempt to close the tab, Postman prompts
you to save your changes.

Busy tabs

Busy tabs ensure you don’t lose your current request, even if it isn’t in a
collection. When you’re in a busy tab and open a new request from the sidebar,
Postman opens the request in a new tab and doesn’t replace or interfere with the
request in the previous busy tab.

What makes a tab busy? When you work in a tab it becomes busy. For example, when
you receive a response or make a change that’s not yet saved (reflected by an
orange dot on the tab), the tab is busy.

Tab and sidebar behavior

By default, Postman assumes you want to work on one collection request in one
tab. When you open a request from the sidebar, Postman opens a new tab when an
existing tab has unsaved changes. If not, the request takes over the current
tab. You can always open a request in a new tab from the sidebar under
the Collections tab. Right click a request and select “Open in New Tab”.

Tab menu

Postman offers several tab actions to help you manage your work.



To access the Tab menu, click the three dots on the right side of a tab. A
dropdown menu appears with options to manage your tabs.

 * Duplicate Current Tab
 * Close Current Tab
 * Force Close Current Tab
 * Close All but Current Tab
 * Close All Tabs
 * Force Close All Tabs

When you “Force Close Current Tab” or “Force Close All Tabs”, the tab closes
immediately without prompting you to save your work in the tab.

When you “Close Current Tab”, “Close All but Current Tab”, or “Close All Tabs”,
a dialogue box appears with an option to save your work.



Moving requests

In the request builder, you can drag and drop tabs to reorder them, open a new
request in a new tab, or in a new Postman window. You also can open multiple
windows using the New Window icon in the header toolbar or the keyboard
shortcut.


KEYBOARD SHORTCUTS

Keyboard usability is a high priority for any development tool. For most
developers, keyboard shortcuts are a more efficient input method that requires
minimum movement and effort as compared to navigating with a cursor. For
repetitive or frequent tasks, keyboard shortcuts improve speed over the long
run.

Postman categorizes keyboard shortcuts as navigation, manipulation, and global.

 * Navigational shortcuts let you move around the interface.
 * Manipulation shortcuts let you manipulate the current selection.
 * Global shortcuts let you access from anywhere.

Navigational Shortcuts

Postman designs navigational shortcuts to help you navigate quickly between
elements. For example, suppose you want to open and send a series of saved
requests without a keyboard shortcut. You would have to select a request in the
sidebar with a pointer each time to open it in the tab.

With a keyboard shortcut, such as CMD/CTRL + ALT + 1, you can focus the sidebar
from wherever you are in interface. You can then navigate to the request you
want with the arrow keys. And if you combine the CMD/CTRL + ALT + 1 shortcut
with the CMD/CTRL + Enter shortcut, you can send a number of requests quickly.

Manipulation Shortcuts

Manipulation shortcuts allow you to quickly work on your current selection and
perform actions such as edit, delete, and duplicate. You can combine
navigational and manipulation shortcuts to create and organize collections in
your sidebar easily. You can also use these shortcuts in other list views, such
as the data editor.

Global Shortcuts

You can use global shortcuts to perform actions regardless of the element in
focus. Examples of such global actions include “Save” (CMD/CTRL + S), “Save
As” (CMD/CTRL + Shift + S), and “Send Request” (CMD/CTRL + Enter).

You can also use global shortcuts to perform user interface actions such as
“Toggle to Sidebar” (CMD/CTRL + ), “Jump to URL” (CMD/CTRL + L), and “Open
Console” (CMD/CTRL + ALT + C).

View keyboard shortcuts for your OS

Different operating systems have different shortcuts.  

You can always view a complete list of your operating system’s shortcuts when
you click the Keyboard Shortcuts icon in the Status bar.



Reference for all shortcuts

TABS macOS Windows / Linux shortcuts Open New Tab ⌘ T Ctrl + T Close Tab ⌘ W
Ctrl + W Force Close Tab Cmd + Alt + W Ctrl + Alt + W Switch To Next Tab ⇧ ⌘ ]
Ctrl + Shift + ] Switch To Previous Tab ⇧ ⌘ [ Ctrl + Shift + [ Switch To Tab at
Position ⌘ 1 through ⌘ 8 Ctrl + 1 through Ctrl + 8 Switch To Last Tab ⌘ 9 Ctrl +
9 Open Request from Sidebar in New Tab ⌥ ⌘ (click) Ctrl + Shift + (click)
REQUEST     Request URL ⌘ L Ctrl + L Save Request ⌘ S Ctrl + S Save Request As ⇧
⌘ S Ctrl + Shift + S Send Request ⌘ ↵ Ctrl + Enter Send And Download Request ⌥ ⌘
↵ Ctrl + Alt + Enter Scroll To Request ⌥ ⌘ ↑ Ctrl + Alt + ↑ Scroll To Response ⌥
⌘ ↓ Ctrl + Alt + ↓ Beautify raw Request body ⌘ B Ctrl + B SIDEBAR     Search
Sidebar ⌘ F Ctrl + F Toggle Sidebar ⌘ \ Ctrl + \ Next Item ↓ ↓ Previous Item ↑ ↑
Expand Item → → Collapse Item ← ← Select Item ↵ Enter Rename Item ⌘ E Ctrl + E
Group Items ⌘ G Ctrl + G Cut Item ⌘ X Ctrl + X Copy Item ⌘ C Ctrl + C Paste Item
⌘ V Ctrl + V Duplicate Item ⌘ D Ctrl + D Delete Item ⌫ Del INTERFACE     Zoom In
⌘ + Ctrl + + Zoom Out ⌘ - Ctrl + - Reset Zoom ⌘ 0 Ctrl + 0 Toggle Two-Pane View
⌥ ⌘ V Ctrl + Alt + V Switch To Sidebar ⌥ ⌘ 1 Ctrl + Alt + 1 Switch To Builder ⌥
⌘ 2 Ctrl + Alt + 2 WINDOWS AND MODALS     New Requester Window ⌘ N Ctrl + N New
Runner Window ⇧ ⌘ N Ctrl + Shift + N New Console Window ⌥ ⌘ C Ctrl + Alt + C
Import ⌘ O Ctrl + O Manage Environments ⌥ ⌘ E Ctrl + Alt + E Settings ⌘ , Ctrl
+ , Submit Modal ⌘ ↵ Ctrl + Enter Open Shortcut Help ⌘ / Ctrl + /

Mouse actions

To close a tab, right click the tab to display the Tab menu, and click the Close
button. Or click the X icon on the right side of the tab to close it.

To force close a tab, press ALT and click the X icon on the right side of the
tab.


DATA EDITOR

Working with large amounts of data can be cumbersome and time
consuming. Postman’s data editor lets you view and manipulate data in a
fast, effective, and elegant manner. Since most users work with data in
spreadsheets, we leveraged those features for the data editor design to make it
a familiar experience.

Note: The UI images in this section do not reflect the current UI that features
the New button.

Visual layout

We’ve configured the available horizontal and vertical space more effectively to
optimize the data you can display up front.

On hover, relevant features display for a specific row to reduce clutter in the
interface and help you focus on the most relevant data.



Mulitple rows

Drag your mouse to select multiple rows.



Keyboard shortcuts for the data editor

Data editor macOS Windows / Linux shortcuts Navigation arrow keys (↑,→,↓,←) +
Tab arrow keys (↑,→,↓,←) + Tab Duplicate row ⌘ D Ctrl + D Select specific rows ⌘
(click) Ctrl + (click) Select previous rows ⇧ ↑ Shift + ↑ Select next rows ⇧ ↓
Shift + ↓ Select current row ⇧ → Shift + → Select current row ⇧ ← Shift + ← Move
row(s) up ⌘ ⇧ ↑ Ctrl + Shift + ↑ Move row(s) down ⌘ ⇧ ↓ Ctrl + Shift + ↓ Copy -
can multiselect and copy rows ⌘ C Ctrl + C Cut - can multiselect and cut rows ⌘
X Ctrl + X Paste ⌘ V Ctrl + V Delete - can multiselect and delete rows ⌫ Del
Deselect rows ⎋ Esc



Bulk actions

You can select and copy multiple rows and then paste them in a different places
(such as ‘params’).



Front view of information

You can display the information you want to see up front. If you navigate to a
place with a large amount of data, the UI element auto expands to show the
complete information in the data editor as well as the URL bar.



Resizing columns

You can change the width of the key and value columns when you drag the boundary
on the right side of the ‘key’ column header.



Multiline support

The data editor supports sending multiline values. Press ‘Enter’ in a key or
value field to expand it and move the cursor to a new line.



Creating the first collection Postman account
Postman account
Postman
 * Launching Postman
    * Installation and updates
    * Sending the first request
    * Creating the first collection
    * Navigating Postman
    * Postman account
    * Syncing
    * Settings
    * New button

 * Sending API requests
    * Requests
    * Responses
    * History
    * Troubleshooting API requests
    * Debugging and logs
    * Authorization
    * Cookies
    * Certificates
    * Capturing HTTP requests
    * Interceptor extension
    * Proxy
    * Generate code snippets
    * Making SOAP requests

 * Collections
    * Creating collections
    * Sharing collections
    * Managing collections
    * Using Markdown for descriptions
    * Examples
    * Data formats

 * Scripts
    * Intro to scripts
    * Pre-request scripts
    * Test scripts
    * Test examples
    * Branching and looping
    * Postman Sandbox
    * Postman Sandbox API reference

 * Environments and globals
    * Variables
    * Manage environments
    * Manage globals

 * Collection runs
    * Starting a collection run
    * Using environments in collection runs
    * Working with data files
    * Running multiple iterations
    * Building workflows
    * Sharing a collection run
    * Debugging a collection run
    * Command line integration with Newman
    * Integration with Jenkins
    * Integration with Travis CI
    * Newman with Docker

 * Team Library
    * Setting up a Team Library
    * Sharing
    * Activity feed and restoring collections
    * Searching
    * Conflicts

 * API documentation
    * Intro to API documentation
    * Viewing documentation
    * Environments and environment templates
    * How to document using Markdown
    * Publishing public docs
    * Adding and verifying custom domains
    * Adding team name and logo

 * Monitors
    * Intro to monitors
    * Setting up a monitor
    * Viewing monitor results
    * Monitoring APIs and websites
    * Set up integrations to receive alerts
    * Pricing for monitors
    * Troubleshooting monitors
    * FAQs for monitors

 * Mock servers
    * Setting up a mock server
    * Mocking with examples
    * Mocking with the Postman API
    * Matching algorithm

 * Postman API
    * Intro to the Postman API
    * Continuous Integration

 * Notifications
 * Workspaces
    * Intro to workspaces
    * Creating workspaces
    * Managing Workspaces
    * Using Workspaces

Postman Pro
 * What is Postman Pro
 * Managing Postman Pro
    * Activating your Pro trial
    * Purchasing Postman Pro
    * Upgrading to Postman Pro from a trial
    * Team settings
    * Changing your plan
    * Managing your team
    * Managing your billing

 * Integrations
    * Intro to integrations
    * APIMatic
    * BigPanda
    * Datadog
    * Dropbox
    * GitHub
    * GitLab
    * HipChat
    * Keen
    * Microsoft Flow
    * Microsoft Teams
    * PagerDuty
    * Slack
    * VictorOps

 * API Search
    * Searching APIs

Postman Enterprise
 * Intro to Enterprise
 * Single sign-on (SSO)
    * Intro to SSO
    * Single sign-on for users
    * Single sign-on for admins
    * Setting up custom SAML in Duo
    * Setting up custom SAML in GSuite
    * Setting up custom SAML in Okta
    * Setting up custom SAML in Onelogin
    * Setting up custom SAML in Ping Identity

Postman for Publishers
 * Public API documentation
 * Run in Postman
    * Creating the Run in Postman button
    * Using the Run in Postman button
    * Updating collections for Run in Postman
    * Environments in Run in Postman
    * Run button API
    * Security considerations

Videos
 * Videos

Reference
 * Reference

Plans & Pricing
Overview
Postman
Postman Pro
Postman Enterprise
Features
Documentation
Mock Servers
Monitoring
Postman API
Integrations
Newman
Support
Downloads
Release Notes
Docs
Forum
Resellers
Help Center
Company
About
Jobs
Company Resources
Contact
Blog
Resources
Community
API Network
Security
Privacy and Terms
Status
Want stickers?

© 2018 Postdot Technologies, Inc.All Rights Reserved

 * Docs Version 5.x Docs Version 6.x
 * HOME
 * PRODUCT
 * SOLUTIONS
   * Publishers
   * DevOps
   * QA
   * Front-end
   * Back-end
 * PLANS & PRICING
 * DOCS
 * API NETWORK
 * SIGN IN
 * DASHBOARD