description [text-string]
Applies a descriptive text label to a physical or logical interface. This metadata is entirely non-operational (it does not affect traffic passing through the port), but it is a critical baseline for asset tracking, remote management, and structured troubleshooting.
Quick Reference
Switch(config-if)#no description ImpliedSyntax Rules
Unlike many other Cisco IOS parameter paths (like hostnames or VLAN tags), the description string allows spaces and special punctuation.
You do not need to encapsulate the string in quotation marks. Everything typed after the word description until you hit the Enter key becomes the exact metadata string pinned to that interface ASIC.
CLI Deployment Scenarios
Scenario 1: Documenting a Core Trunk Link
You want to clearly label a critical fiber link pointing back to the core routing layer so other admins don't accidentally shut it down.
Scenario 2: Erasing a Description
A server is unhooked from a port, and you need to clear the description tag to prepare the interface for reuse.
CCNA Exam Gotchas
The Verification Visibility Trap
If you run a basic show ip interface brief verification command, your custom port descriptions will not appear in the terminal table list.
To quickly inspect descriptions for mapping protocols or verification loops, you must use specialized modifiers like show interfaces description or parse out the running configuration block.