Skip to contentPorsche Design System
You are currently viewing an earlier release of the Porsche Design System.Switch to the latest Porsche Design System documentation.
SearchGitHub repository of Porsche Design SystemOpen settings sidebar
Heading Table of Contents Accessibility support This component does not include any special accessibility features. Development considerations Heading hierarchy While using the Heading component, take care of the correct heading hierarchy which can be adjusted through the tag property. Keep in mind that the visual appearance must not always be identical with the semantic hierarchy. Best practices Use one unique h1 per page that describes what that page is about. Use headings to describe the content below. Do not use an HTML heading just to make the text appear bigger or stand out. Use heading levels like the index of a book: hierarchical. Do not choose a heading by its size, but by its level in the context of the content. Heading hierarchy should not increase by more than one level at a time. Do not skip a heading level from the top down. Common do's and don'ts Do use the tag prop to reflect the semantic hierarchy, not just visual size. Do keep one unique h1 per page. Don't choose a heading level based on appearance alone. Don't skip heading levels when nesting sections. Integration examples
Skipped heading level❌ Anti-pattern
<p-heading tag="h1" size="xl">
  Configure your Porsche
</p-heading>

<p-heading tag="h4" size="md">
  Delivery options
</p-heading>
✅ Recommended
<p-heading tag="h1" size="xl">
  Configure your Porsche
</p-heading>

<p-heading tag="h2" size="md">
  Delivery options
</p-heading>
Tests Automated TechnologySupportAXE-Core (WCAG 2.2 AA, Best-Practice)✅High-Contrast Mode (light/dark)✅Text-Zoom (200%)✅ Manual TechnologySupportScreen reader (VoiceOver, NVDA)✅
Global settingsColor SchemeAll color tokens use the light-dark() CSS function. Set the theme via the CSS color-scheme property: light for light mode, dark for dark mode, or light dark to follow the user's system preference.LightDarkLight DarkDirectionThe dir global attribute in HTML changes the direction of text and other content within an element. It's most often used on the <html> tag to set the entire page's direction, which is crucial for supporting languages that are written from right to left (RTL), such as Arabic and Hebrew. For example, using <html dir="rtl"> makes the entire page display from right to left, adjusting the layout and text flow accordingly.LTR (left-to-right)RTL (right-to-left)Text ZoomTo ensure accessibility and comply with WCAG 2.2 AA standards, it is mandatory for web content to support text resizing up to at least 200% without loss of content or functionality. Using relative units like rem is a best practice for achieving this, as they allow the text to scale uniformly based on the user's browser settings.100%130%150%200%