BuildTheNet

Opening your workspace

Your learning content and tools are loading.

Switching Basics

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     down

Reference 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

What each column or field means

FieldMeaning
InterfaceShort interface name.
Statusup, down or admin down (shut).
ProtocolLine protocol state.
DescriptionThe 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

Topic

Switching Basics — How a switch learns MAC addresses, how to read interface status, and how to fix speed, duplex and administratively down ports.

All 57 commands