show interfaces description
Lists every interface with its status, protocol and the description configured on it.
Written by a working field network engineer · CCNA, Security+, CySA+
A compact list of every interface with its state and description. On a switch with dozens of ports, descriptions are what turn “Gi1/0/37” into “Floor 2 printer”, and this is the quickest way to read them.
Example output
SW1#show interfaces description
Interface Status Protocol Description
Fa0/1 up up
Fa0/2 up up
Fa0/3 admin down down
Fa0/4 admin down down
Fa0/5 admin down down
Fa0/6 admin down down
Fa0/7 up up
Fa0/8 up up
Gi0/1 up up
Gi0/2 admin down down
Po1 up up
Vl1 admin down downReference output: hand-written in standard Cisco IOS format for this example network, not captured from a device. No descriptions are configured in this example network, which is the usual state of a new switch and the first thing to fix.
Useful variants
sh int descshow interfaces description | include up
What each column or field means
| Field | Meaning |
|---|---|
Interface | Short interface name. |
Status | up, down or admin down (shut). |
Protocol | Line protocol state. |
Description | The text set with the description interface command. Empty if none is configured. |
When it doesn’t look right
Ports have no descriptions.
Add them with description <text> under each interface. Describing the far end (device and port) makes every later outage faster to work.
A description says one thing and CDP says another.
The cabling changed and the description did not. Trust show cdp neighbors and update the description.
Related commands
Try it yourself
Learn it in the CCNA path
- Describe ports and read one interface's configuration (2. Network Access)
- Configure a range of ports at once and shut the unused ones (2. Network Access)
Topic
Switching Basics — How a switch learns MAC addresses, how to read interface status, and how to fix speed, duplex and administratively down ports.