Repository navigation
Global Styles
Global Styles is the system that controls your site-wide design settings in the WordPress Site Editor. Through Global Styles, you can customize typography, colors, spacing, and layout at the global level or per-block type.
- Navigate to Appearance → Editor to open the Site Editor.
- Click the Styles icon (half-filled circle) in the top-right toolbar.
- The Styles panel opens on the right side.
The Global Styles panel contains the following sections:
| Section | What It Controls |
|---|---|
| Browse styles | Style variation selector |
| Typography | Font families, sizes, weights, line heights |
| Colors | Palette, backgrounds, text, links, buttons |
| Layout | Content width, padding, block gap |
| Blocks | Per-block type style overrides |
Configure site-wide text settings:
- Click Typography in the Styles panel.
- Choose an element to configure:
- Text — Body text defaults.
- Links — Link appearance and hover states.
- Headings — All heading levels (H1–H6).
- Captions — Image and block captions.
- Buttons — Button text styling.
| Option | Description |
|---|---|
| Font family | Choose from Lexend (body), Lexend Deca (headings), or JetBrains Mono (code). |
| Size | Select from the fluid type scale (8px to 96px with clamp()). |
| Appearance | Font weight (thin through black) and style (normal or italic). |
| Line height | Relative line height value. |
| Letter spacing | Additional space between characters. |
| Text decoration | Underline, strikethrough, or none. |
| Text transform | Uppercase, lowercase, capitalize, or none. |
See typography for the full type scale and font details.
Aegis provides a comprehensive color palette based on the Tailwind CSS v3 scale:
- Primary (Zinc) — 25 through 950 shades.
- Neutral — 0 through 950 shades.
- Success (Green) — 50 through 950 shades.
- Warning (Orange) — 50 through 950 shades.
- Error (Red) — 50 through 950 shades.
See color-palette for the complete color reference.
Configure colors for specific elements:
| Element | What It Affects |
|---|---|
| Background | Page and section backgrounds |
| Text | Default body text color |
| Links | Anchor text color and hover state |
| Headings | Heading text color (H1–H6) |
| Captions | Caption text color |
| Buttons | Button background and text color |
To add a custom color:
- In the Colors section, click Palette.
- Switch to the Custom tab.
- Click the + button to add a new color.
- Use the color picker or enter a hex/RGB value.
- Name the color for easy reference.
Configure content dimensions and spacing:
| Setting | Default | Description |
|---|---|---|
| Content size | 720px (max) | Maximum width for standard content. |
| Wide size | 1620px (max) | Maximum width for wide-aligned blocks. |
| Padding | Based on spacing scale | Space between content and viewport edges. |
| Block spacing | Based on spacing scale | Vertical gap between blocks. |
See layout for detailed layout configuration.
Global Styles allows you to set default styles for specific block types:
- In the Styles panel, scroll to the Blocks section.
- Click Blocks or search for a specific block type.
- Configure typography, colors, dimensions, and spacing for that block.
- These settings become the default for all instances of that block type.
- Navigate to Styles → Blocks → Button.
- Set the background color, text color, border radius, and padding.
- Save — all Button blocks across your site will use these defaults.
Individual blocks can still override these defaults through their own block settings.
The Site Editor does not provide a direct export button, but your style customizations are stored in the database as a wp_global_styles custom post type. You can export them by:
- Copying the relevant portions of your customized
theme.jsonstructure. - Using the WordPress REST API to retrieve the global styles object.
To clear all style customizations and return to the theme defaults:
- Open the Styles panel.
- Click the Options menu (three dots at the top).
- Select Reset to defaults.
- Confirm the action.
This removes all your custom overrides but does not change which style variation is active.
Global Styles in the editor correspond directly to the theme.json configuration:
- Settings define what options are available (which fonts, which colors, which sizes).
- Styles define the default values applied to elements and blocks.
When you make changes in the Styles panel, WordPress stores them as overrides on top of the theme.json file shipped with Aegis. The original file is never modified.
- Start with a style variation that is close to your desired design, then fine-tune individual settings.
- Use the per-block section to maintain consistency across all instances of a block type.
- Test on multiple templates to ensure your style changes look correct on posts, pages, and archives.
- Save regularly — the Styles panel requires an explicit save action.
- style-variations — Choose a style variation as your starting point.
- color-palette — Understand the full color system.
- typography — Explore the type scale and font options.
- spacing — Learn about the spacing scale.
- dark-mode — Configure dark mode styling.
Aegis version 1.0.0 | GitHub Repository | Report an Issue | Atmostfear Entertainment
License: GPL-2.0-or-later