Docs / Getting started

Recommended setup

The few steps that give the best results right after installing GeneratePerf.

1. Install the GeneratePerf child theme

Download the GeneratePerf Child Theme from the Downloads tab of your account, then in WordPress go to Appearance → Themes → Add New → Upload Theme and activate it (GeneratePress must be installed).

It is where your customisations live: your styles in style.css, your PHP in inc/functions-custom.php (every GeneratePerf hook is listed there with an example, see Hooks), your SVG icons in images/icons/, your HTML shortcodes in shortcodes/ and the files of CSS overrides in css/. Once installed, the child theme is yours: GeneratePerf updates never overwrite it. Site Health checks that a child theme is active.

2. Define the site colors

GeneratePerf’s components use seven GeneratePress global colors, by slug: primary, secondary, lightest, light, medium, dark and darkest. Their names are free.

When you activate the GeneratePerf child theme, the colors missing from your palette are added automatically, and the existing ones are never changed. A missing color takes the value of its GeneratePress equivalent when there is one (accent for primary, contrast for darkest, contrast-2 for dark, contrast-3 for medium, base for light, base-3 for lightest); otherwise its default value:

Slug Default
primary #1E73BE
secondary #BE691E
lightest #ffffff
light #e9e9e9
medium #919191
dark #757575
darkest #222222

Adjust them in Appearance → Customize → Colors. If a color goes missing later, Site Health reports it and its Add the missing colors button restores it the same way.

3. Let the configurator set up your other plugins

If you use WP Rocket, Perfmatters, Imagify, Cache Enabler or ShortPixel, open 1 Clic Configurator and apply the recommended configuration: it sets their options for a GeneratePress site in one click.

4. Turn on the performance options for your content

In Web performance, enable for your posts and pages:

  • Prioritize featured images (fetchpriority="high") and Early-load featured images (no lazy-loading);
  • Early-load first content images on content without a featured image;
  • Preload featured images where the featured image is the largest element of the page.

5. Choose self-hosted fonts

Pick your fonts in Appearance → Customize → Typography: GeneratePerf’s fonts are served from your own site, with fallbacks that avoid layout shifts. See Fonts.

6. Check Site Health

Open Settings → GeneratePerf → Site Health and fix what it reports: search engine visibility, plugin version, colors, child theme, editor and the size of autoloaded options.