Set map styles and icons
A map style decides how every network map, documented diagram, and export draws its links: the color, width, and line of each kind of link, and whether faster links are drawn wider. It also sets what an exported drawing carries around it, and which icon each device gets. Set it once for your organization. On the MSP plan, a client can override any part of it, for example to match a client’s own cabling color code.
Outpost ships with defaults that follow common cabling conventions, so you only need to change what your practice does differently.
Before you begin
Section titled “Before you begin”- Changing styles and icons needs
network_map:manage. Anyone withdiscovery:readcan see them. - A change applies the next time a map is drawn or exported. Diagrams already saved keep the styles they were drawn with until you redraw them. See Keep documented network diagrams.
Set your link styles
Section titled “Set your link styles”- Go to Settings > Network maps.
- Under Link styles, for each kind of link you want to change, set the Color, the Width (0.5 to 8), and the Line: Solid, Dashed, Dotted, or Double. Preview shows the result.
- Select Save.
Each link gets one style, picked in this order: its media when Outpost knows it, else its role, such as a trunk or a VPN, else whether it is physical or logical. A link that is inferred or not seen recently is drawn dashed, and a link not seen recently also takes that row’s color. Reset to defaults returns the link styles, speed widths, and sheet options to the shipped defaults. Icons are not affected.
The shipped defaults
Section titled “The shipped defaults”| Link | Color | Line |
|---|---|---|
| Single-mode fiber | Yellow, #e6b400 | Solid |
| Multimode fiber (OM1/OM2) | Orange, #f28c28 | Solid |
| Multimode fiber (OM3/OM4) | Aqua, #12a4a8 | Solid |
| Multimode fiber (OM5) | Lime green, #7dba2f | Solid |
| Copper | Blue, #2f6fd6 | Solid |
| Direct attach copper | Gray, #6b6f73 | Solid |
| Wireless | Light gray, #8a8f94 | Dotted |
| Physical link (media unknown) | Dark gray, #555b61 | Solid |
| WAN | Dark gray, #555b61, width 2 | Solid |
| VPN | Purple, #7a4fb0 | Dashed |
| Trunk | Dark gray, #555b61 | Double |
| Link aggregation | Dark gray, #555b61 | Solid |
| Stack | Near black, #2b2f33, width 3 | Solid |
| HA sync | Amber, #b7791f | Dotted |
| Logical link | Gray, #6b6f73 | Dashed |
| Depends on | Gray, #6b6f73, with an arrow | Dotted |
| Inferred link | Dark gray, #555b61 | Dashed |
| Not seen recently | Amber, #b7791f | Dashed |
Every width is 1.5 unless the table says otherwise. A link aggregation is drawn 1 wider than its style says.
Draw faster links wider
Section titled “Draw faster links wider”Under Line width by speed, Draw faster links wider is on by default. A link whose speed Outpost knows is drawn at the width of the highest tier it reaches, instead of its style’s width:
| From (Mbps) | Width |
|---|---|
| 0 | 1 |
| 1000 | 1.5 |
| 10000 | 2.5 |
| 25000 | 3.5 |
| 100000 | 5 |
Change a tier’s values, select Add tier or Remove, then select Save. Turn the switch off to draw every link at its style’s width.
Set the drawing sheet
Section titled “Set the drawing sheet”Drawing sheet sets what exported drawings carry around the drawing:
| Option | Effect |
|---|---|
| Title block | The client, site, view, title, author, date, revision, and “Generated by Outpost”. Live map exports leave the author blank. |
| Legend of the link styles used | One row for each kind of link the drawing uses. It appears when a drawing uses two or more. |
| Revision table on documented diagrams | The last 10 revisions, with date, author, and note. |
| Practice logo in the title block | The Logo set under Branding in your sales settings, when you have one. |
| Paper | Letter, Tabloid, A4, or A3, for PDF exports. |
| Orientation | Landscape or Portrait, for PDF exports. |
| Footer | One line of text, up to 200 characters. |
Select Save when you are done.
Override the style for one client
Section titled “Override the style for one client”On the MSP plan, each client can have its own style. What it does not set follows Settings > Network maps.
- Go to Clients and open the client.
- In Network map style, change the rows you want. A row the client has not changed shows Inherited.
- Select Save.
Select Reset on a row to inherit it again, or Use the practice style to clear the whole override.
Add a device icon
Section titled “Add a device icon”Each device on a map is drawn with its kind’s icon. Add your own to show a vendor’s logo or a specific model.
- Under Icons, choose an Image: PNG, WebP, or SVG, at most 64 KiB and 512 by 512 pixels.
- Enter a Name.
- Choose what the icon is for. Set any of Device kind, Vendor, and Model. A device uses the icon only when everything you set matches it. Vendor and model match what discovery or SNMP reports for the device, ignoring case. With none set, the list shows Only devices it is chosen for, and the icon appears in the Outpost devices library of the diagram editor for you to place by hand.
- Select Add icon.
When several icons match a device, it uses the first of: an icon chosen for it in the diagram editor, then one matching its model, then its vendor, then its kind. At each step a client’s own icon comes before the practice’s.
To add an icon for one client only, add it in the client’s Network map style panel instead. Practice icons are listed there with Practice and can be deleted only from Settings > Network maps.
PNG and WebP icons are stored as PNG. An SVG icon is cleaned before it is stored, and one holding scripts, links, embedded images, or references to other files is refused with the reason. PNG and PDF exports draw an SVG icon that uses only plain shapes and solid colors, and the device’s kind icon otherwise.
Verify
Section titled “Verify”Open Endpoints > Network map on the Physical (L1) view. Links whose media Outpost knows follow your colors, faster links are wider, and devices that match an icon show it.
If something goes wrong
Section titled “If something goes wrong”| Symptom | Fix |
|---|---|
| Changing the style needs the network_map:manage permission. | Ask an owner to add network_map:manage to your role. |
| Every link is the same gray | Outpost does not know the links’ media. See How media is worked out, or set it in the link’s details. |
| A device does not use your icon | A field you set on the icon does not match the device. Check the device’s vendor and model in its details on the map. |
Next steps
Section titled “Next steps”Content is licensed CC BY 4.0. Code samples are MIT. Outpost and the Outpost mark are trademarks of Outpost Business Solutions, PBC and are not covered by either license.