## Overview

The Simple Headline widget allows you to insert simple headlines. It creates visually styled page headers with a large decorative icon, custom colors, and optional subtitle. The widget displays the page's icon as a large semi-transparent watermark in the background, combined with customizable title and subtitle text.

## Use Cases

### Page Header Enhancement
Add visually appealing headers to important pages, creating a professional and branded look. The widget allows consistent headline styling across different page types, helping differentiate content through visual design.

### Visual Page Hierarchy
Make landing pages or section entry points stand out with prominent headers. The combination of custom colors, large text, and decorative icons provides clear visual distinction between different page types and guides users through content organization.

### Branded Content Sections
Apply corporate colors to page headers and create consistent visual themes across page collections. The widget supports multi-language content through localized titles and subtitles, enabling branded experiences for international users.

### Dashboard and Overview Pages
Create attention-grabbing headers for dashboard pages and overview sections. The two-level text hierarchy (title and subtitle) allows you to provide both main headings and explanatory context.

## Design Considerations

### When to Use This Widget

Choose the Simple Headline widget when:
- Standard page titles lack sufficient visual prominence
- You need to apply custom branding or colors to specific pages
- You want both a main title and explanatory subtitle
- You need to incorporate the page icon in a decorative way
- You're creating landing pages, dashboards, or important section headers

### When NOT to Use This Widget

Avoid this widget when:
- Simple page titles are sufficient for your needs
- You need complex header functionality (interactive elements, buttons, etc.)
- The page layout requires a standard widget frame or padding
- You're working with non-page entities (widget only works on Page types)

### Visual Design Features

The widget provides responsive design across three breakpoints:
- **Desktop (>767px)**: Full-size display with maximum visual impact
- **Tablet (<=767px)**: Medium-size display with balanced layout
- **Mobile (<=579px)**: Compact display optimized for small screens

Typography scales automatically:
- Desktop: Title 40px, Subtitle 24px, Icon 100px
- Tablet: Title 30px, Subtitle 20px, Icon 70px
- Mobile: Title 20px, Subtitle 14px, Icon 50px

The widget renders without frame or padding, creating seamless integration with the page layout. Text shadows are applied for readability over the decorative icon background.

## Common Pitfalls

- **Entity Type Limitation**: Widget only works on Page entities. Cannot be embedded in other entity types.
- **Static Display Only**: Widget provides no interactive features. If you need buttons, links, or other interactions in your header, use a different approach.
- **Fixed Visual Style**: While colors are customizable, the overall layout and design pattern is fixed. Limited flexibility for radically different header designs.

## Related Patterns

- **Standard Page Titles**: For pages where simple text titles are sufficient
- **Custom Header Widgets**: For pages requiring interactive header elements or complex layouts
- **Image Widgets**: For pages where photographic headers are more appropriate than icon-based headers