Search
  • Software
    • Overview
    • OpenStack Components
    • SDKs
    • Deployment Tools
    • OpenStack Map
    • Sample Configs
  • Use Cases
    • Users in Production

    • Ironic Bare Metal
    • Edge Computing
    • Telecom & NFV
    • Science and HPC
    • Containers
    • Enterprise
    • User Survey
  • Events
    • OpenInfra Summit
    • Project Teams Gathering
    • OpenDev
    • Community Events
    • OpenStack & OpenInfra Days
    • Summit Videos
  • Community
    • Welcome! Start Here
    • OpenStack Technical Committee
    • Speakers Bureau
    • OpenStack Wiki
    • Get Certified (COA)
    • Jobs
    • Marketing Resources
    • Community News
    • Superuser Magazine

    • OpenInfra Foundation Supporting Organizations
    • OpenInfra Foundation
  • Marketplace
    • Training
    • Distros & Appliances
    • Public Clouds
    • Hosted Private Clouds
    • Remotely Managed Private Clouds
    • Consulting & Integrators
    • Drivers
  • Blog
  • Docs
  • Join
    • Sign up for Foundation Membership
    • Sponsor the Foundation
    • More about the Foundation
  • Log In

Use recommended UI panel formatting

Use recommended UI panel formatting¶

It is important to use consistent style and placement for text and icons in the UI.

Workflow navigation text¶

Use default values for page or window title bars, side navigation, fonts, and text size. For example, tab titles must be a smaller text size than the section heading.

Similarly, the node item title must be a smaller font than the page or window title. If necessary, you might have to shorten the node item title in order to maintain the default width.

Note

The image below is not to scale. It is only intended as a reference for the various UI elements mentioned.

UI text cheat sheet

Icons¶

Be selective when deciding to use icons instead of text. It is often difficult for users to understand the intent of an icon. New icons should be thoroughly reviewed and tested by the user experience project. That said, icons can improve usability in specific instances.

For example:

  • You have limited space.

  • The icon is quickly recognizable.

    Note

    Consider global audiences and whether the icon is recognizable across cultural differences.

  • The icon enhances design appeal.

If you decide to use an icon, follow these tips:

  • Keep the design simple and consistent.

  • Keep the location of individual icons consistent. Users recognize and expect patterns which help to establish meaning and function.

  • Ensure the icon is quickly recognizable and memorable. For help, work with the UX project.

  • If there is space, consider adding a text label to the icon.

this page last updated: 2025-05-02 14:25:12
Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug
  • Guides
  • Install Guides
  • User Guides
  • Configuration Guides
  • Operations and Administration Guides
  • API Guides
  • Contributor Guides
  • Languages
  • Deutsch (German)
  • Français (French)
  • Bahasa Indonesia (Indonesian)
  • Italiano (Italian)
  • 日本語 (Japanese)
  • 한국어 (Korean)
  • Português (Portuguese)
  • Türkçe (Türkiye)
  • 简体中文 (Simplified Chinese)

Documentation Contributor Guide

  • Quickstart
  • Documentation team structure
  • 2017/2018 documentation team vision
  • Non-native English speakers
  • Blueprints and specifications
  • Project guide setup
  • Landing pages on docs.openstack.org
  • Governance tag documentation guidelines
  • OpenStack API documentation
  • Documentation bugs
  • Writing documentation
  • Writing style
  • OpenStack user experience and user interface guidelines
    • OpenStack personas
    • GUI guidelines
    • UI text guidelines
  • RST conventions
  • JSON conventions
  • Diagram guidelines
  • Reviewing documentation
  • Building documentation
  • Redirecting documentation
  • Using documentation tools
  • Publishing a documentation release
  • Glossary

Page Contents

  • Use recommended UI panel formatting
    • Workflow navigation text
    • Icons

OpenStack

  • Projects
  • OpenStack Security
  • Blog
  • News

Community

  • User Groups
  • Events
  • Jobs
  • Companies
  • Contribute

Documentation

  • OpenStack Manuals
  • Getting Started
  • API Documentation
  • Wiki

Branding & Legal

  • Legal Docs
  • Logos & Guidelines
  • Trademark Policy
  • Privacy Policy
  • OpenInfra CLA

Stay In Touch

The OpenStack project is provided under the Apache 2.0 license. Docs.openstack.org is powered by Rackspace Cloud Computing.