Skip to main contentIBM Design Language

Technical diagrams

Technical diagrams require thoughtful arrangement and application of a wide variety of elements to deliver information with clarity. Consider the following guidelines when creating technical diagrams.

Examples in use

Clarity

When creating a technical diagram, clarity and legibility are paramount. These guidelines were developed to help, as well as ensure brand consistency. Try to follow them as closely as possible. Depending on the tools used to create diagrams, there may be certain limitations, however clarity should never be sacrificed.

Always add a legend to your diagram, showing the color, line, style and shape conventions used.

Always add a legend to your diagram, showing the color, line, style and shape conventions used.

Don’t use icons by themselves to represent essential information—always use words, as well.

Don’t use icons by themselves to represent essential information—always use words, as well.

When a diagram can’t be displayed at 100% scale, offer the user a way to download it or zoom in.

When a diagram can’t be displayed at 100% scale, offer the user a way to download it or zoom in.

Alternate background fill colors to improve nesting readability.

Alternate background fill colors to improve nesting readability.

Avoid redundancy when using shapes, styles, colors or indicator badges.

Avoid redundancy when using shapes, styles, colors or indicator badges.

Don’t mix types of nodes unless they have specific semantic differences that can’t be expressed otherwise.

Don’t mix types of nodes unless they have specific semantic differences that can’t be expressed otherwise.

Carbon

The technical diagrams guidance presented here is meant for diagrams that appear outside of product screens, such as those found in documentation websites, in presentations, on collateral and so on. When creating a technical diagram as part of a product, use the Carbon components and Carbon for IBM Products guidance instead.

Subsystems

Using our technical diagram guidance as a foundation, some teams have expanded on our system. They’ve built a number of discrete extensions, effectively creating subsystems that specifically address their exact use cases. If you work with one of these subsystems, follow our general guidance, as well as the specific adaptations applicable to your use case. If you believe you have an application that requires new elements, reach out to the IBM brand design team with your proposal for approval. It helps ensure that your technical diagram subsystem adheres to our general guidance, and gives us the opportunity to share it here with all teams.

IT architecture

The IBM Unified Method Framework is the modelling standard used by IBM for IT architecture. When creating an IT architecture diagram, follow the visual guidance developed specifically for this type of diagram. Doing so helps ensure correct interpretation of your architectural model.

Product documentation

All products created by IBM have some related documentation. Often, this documentation includes various types of technical diagrams, such as flows, process diagrams, network diagrams and so on. Whenever you need to create a diagram representing a system of parts and the relationship between them, start from our general technical diagrams guidance. Various teams have developed subsystems tailored to their specific applications. Check this Box folder for customized kits.