Skip to main content

Titles and headings

Hierarchically nested headings improve content scannability, making it easier for readers to find what they need at a glance.

Use headings to structure content​

In markdown and HTML-based content, titles are typically formatted using H1 headings (#), and top-level section headings generally are formatted using H2 format (##).

Large blocks of text should be chunked and nested into progressively smaller header levels. To create a hierarchical structure, add H3 subsections and further H4 subsections.

Write concise headings with keywords​

Search Engine Optimization and Generation Engine Optimization increase when content is structured around meaningful section headings that are front-loaded with keywords.

Include two or more H2 headings per page​

Don't create pages with a single H2 heading; H2 headings set an expectation for multiple sections.

Use sentence-case capitalization​

Capitalize the first word in any title, heading, or subheading. Also, capitalize proper nouns and product names, including third-party names, in titles, headings, and subheadings (for example, "ActiveGate," "Smartscape," "iPhone," and "Dynatrace OneAgent"). Write all other words in lowercase.

✅ The DPS license model allows broad adoption of Infrastructure Monitoring
❌ The DPS License Model Allows Broad Adoption of Infrastructure Monitoring
✅ How Dynatrace boosts production resilience with Site Reliability Guardian
❌ How Dynatrace Boosts Production Resilience with Site Reliability Guardian

The sentence-case rule for titles, headings, and labels applies even when a number precedes phrases.

✅ 24/7 availability monitoring
❌ 24/7 Availability monitoring
✅ 3 user sessions
❌ 3 User Sessions

Avoid punctuation in headings​

Avoid closing punctuation in page titles, headings, and subheadings.

✅ Precise customer communications improve engagement
✅ Dynatrace and cloud providers integrate to help accelerate your cloud transformation
✅ Dynatrace license lifecycle
✅ How the RUM JavaScript injection works
❌ Precise customer communications improve engagement.
❌ Dynatrace and cloud providers integrate to help accelerate your cloud transformation.
❌ Dynatrace license lifecycle.

info

Insert a question mark in a heading only if necessary for clarity or FAQ-style headings.

Add subtitles​

To abbreviate long titles, use a colon symbol (:) followed by a space to break the long title into a shorter title with a subtitle.

  • Capitalize the first word of the subtitle.
  • Don't use a hyphen or an em dash to separate titles and subtitles.

✅ Stay ahead of the game: Forecast IT capacity with Dynatrace Grail and Davis AI
✅ Mobile app monitoring: A simple, all-in-one approach for mobile developers
❌ Stay ahead of the game: forecast IT capacity with Dynatrace Grail and Davis AI
❌ Stay ahead of the game—Forecast IT capacity with Dynatrace Grail and Davis AI

Avoid gerund (...ing) verb forms​

Avoid "ing" gerund verb forms in titles and headings. Use active verb forms wherever possible.

✅ Create an anomaly detector
❌ Creating an anomaly detector
✅ Investigate and compare problems
❌ Investigating and comparing problems