Home » Documentation » OMGF Pro » User Manual

OMGF (Pro) — User Manual

OMGF (Pro)’s settings are grouped into separate tabs. This manual goes through each of these tabs and offers an explanation what each option does and how it affects the way OMGF Pro functions.

Go to Settings > Optimize Google Fonts to open OMGF (Pro)’s settings screen.

Optimize Fonts

These settings affect the fonts OMGF (Pro) downloads and the generated stylesheet(s). Below the screenshot you’ll find a rundown of each option. Once you’re done configuring, you can simply click Save & Optimize.

If Optimization Mode is set to Manual, OMGF (Pro) will immediately scan the defined URL for Google Fonts and show an overview of found fonts. In Automatic mode OMGF (Pro) will start capturing Google Fonts as you (and other visitors) go through the frontend of your site. The Manage Optimized Google Fonts overview will be shown (and adjusted) accordingly.

For both modes, the same logic goes: if the Google Font has been found before and the corresponding stylesheet exists, no call to OMGF’s Download API will be made.

Optimize Fonts: in most situations the default settings should suffice.
Optimization Mode (default: Manual)

Select when you want OMGF (Pro)’s detection and optimization to take place. In most situations Manual will suffice, because most WordPress sites work with a fixed set of fonts throughout the entire site. Some websites, however, use different fonts on different pages. To reduce maintenance (and layout breaks) these website should use the Automatic mode.

Combine & Dedupe Google Fonts (only available in OMGF Pro — always on)

Merges all detected Google Fonts requests into one stylesheet and de-duplicates them. E.g. if your theme is requesting Roboto 400, 600 and 700, and a plugin is requesting Roboto 400 and 900, OMGF Pro will merge this request into Roboto, 400, 600, 700 and 900.

Font-display option (default: Swap)

Only change this if you know what you’re doing. In most situations ‘Swap’ is what you’re looking for, since it increases your Google PageSpeed Insights score.

Force Subsets (only available in OMGF Pro — default: none)

Some plugins/themes load all subsets for the fonts they’re using. This could lead to excessive load in your case. E.g. you don’t need to load Arabic characters, if your site only uses Latin characters. In this example, setting this option to Latin will save you a bit of page size and loading time on each pageview.

Optimize fonts for logged in editors/administrators (default: on)

Only disable this when you’re customizing another theme, using WordPress’ customize feature, or using a drag-and-drop page builder.

Manage Optimized Google Fonts

After saving your changes and running the optimization (Save & Optimize) the Manage Optimized Google Fonts section will be populated with detected Google Fonts:

Font Family and Stylesheet handle

The first column contains the name of the Font Family (e.g. Jost, Martel, Roboto, etc.) and the Stylesheet handle (between parenthesis). In the free version of OMGF this contains the handle defined by the theme or plugin developer, e.g. google-fonts-1. In OMGF Pro this will always be pro-merged followed by a unique identifier.
The unique identifiers are used to create separate stylesheets for each combination of used Google Fonts. If one page uses e.g. Roboto 400, 600 and 700 and Open Sans 300 and 500 then this generated stylesheet is used on every page using the exact same combination. If another page uses the same combination, but also Martel 300, then a separate stylesheet is generated to optimize deliverability.

Style

Displays the style for a font variation, e.g. italic or normal.

Weight

Displays the weight of a font variation, e.g. 300, 500 or 700.

Preload

Check this box to preload this font variation. Preloading a font file will result in the file being loaded before everything else is loaded. This may reduce Cumulative Layout Shifting and avoids FOUT (Flash Of Unstyled Text.) More information

Do not load

Check this box to not load this font variation. If the font variation is not used anywhere, but still loaded (by e.g. a plugin) it is advised to not load (unload) the font using this option. When all boxes of one stylesheet handle are checked, the stylesheet will not be loaded at all.

Detection Settings

These settings affect how OMGF (Pro) searches for fonts throughout your sites and how the found files are processed.

Detection Settings: In most situations, the default settings should suffice.
Google Fonts Processing (default: Replace)

Replace will download all detected Google Fonts in your website’s pages and serve them from a local source. Remove will remove all Fonts, forcing a browser to fallback to system fonts, which is faster, but not necessarily pretty.

Advanced Processing (only available in OMGF Pro — default: on)

Disabling this will effectively disable OMGF Pro and make OMGF fallback to its default behavior/

Font-display option (default: Swap)

Only change this if you know what you’re doing. In most situations ‘Swap’ is what you’re looking for, since it increases your Google PageSpeed Insights score.

Google Fonts Processing (only available in OMGF Pro — default: all on)

If you’re certain that you’re configuration is not loading Google Fonts through e.g. WebFontLoader fonts, or inline stylesheets. You can make OMGF Pro work faster by disabling those features.

Remove Resource Hints (only available in OMGF Pro — default: on)

Most themes/plugins using Google Fonts, add a resource hint pointing to fonts.googleapis.com to the header of each page. Enabling this option removes this resource hint from your header.

Advanced Settings

OMGF Pro’s advanced settings offer ways to fine-tune OMGF Pro’s behavior and make it work with your specific configuration, e.g. when you’re using a CDN.

Do not change these settings, if you don’t know what you’re doing!

Do not change these settings, unless you know what you’re doing.
Save font files to… (default: /uploads/omgf)

The folder where OMGF (Pro) stores its font files and stylesheets. In most cases this doesn’t have to be changed.

Serve fonts from CDN (default: empty)

If you’re using a CDN, enter the full URL (incl. protocol) here to make sure OMGF (Pro) will rewrite the font URLs to point to the CDN.

Serve font files from… (default: empty)

When you’re using Security Through Obscurity plugins, e.g. WP Hide, you might want to change the path where the font files are served from. Enter the path you’ve set in your Security Plugin to access the Uploads folder, and all URLs in the stylesheet will be rewritten to point to that path.

Use Relative URLs (default: off)

In some situations (e.g. Multisite) it could be handy to use relative URLs instead of absolute URLs. Enable this if you think this situation applies to you.

Remove settings and files at uninstall? (default: off)

If you want to uninstall the plugin and all of it’s files and settings, check this setting and save changes, before removing the plugin.