Settings reference

This page lists the settings at Settings → Typography Stylist. The sections are in the order of the tabs. Some settings show only on some WordPress versions.

Custom Fonts

This tab lists your fonts. To change the order of the fonts, drag a font card. The editor font list uses the same order. To open the settings of a font, click its name.

To add a font, use the sections under Add Font:

  • Upload Font Kit: Upload the ZIP file of a webfont kit.
  • Add Adobe Fonts Project: Paste the embed code and type the family names.
  • Add Custom Font Definition: Add a font that your site already loads.

Uploaded kits and Adobe Fonts projects have these settings on their cards:

  • Fallback Fonts (optional): Type fallback fonts, separated by commas. The browser uses them if the font does not load.
  • Load on all pages: Load the font on every page. When this is clear, the font loads only on the pages that use it.
  • Available Font Weights: Clear the weights that the font does not include. The editor then does not offer them.
  • Feature Visibility: Control which features show in the editor for this font.
  • Variable Font: Mark the font as variable and set its axes. See Variable fonts.

On WordPress 6.5 and later, an uploaded kit also has Register in Font Library or Remove from Font Library.

A font from the WordPress Font Library has a Manage in Font Library link. The link opens the Font Library in a new tab. On WordPress 7.1 and later, it opens Appearance → Fonts. On earlier versions, it opens the Site Editor.

See Font management for more information.

Paragraph Styles

This tab lists your saved paragraph styles. Each style shows a preview in its own font and a list of its settings. Click Edit to change any setting of a style, its name, or the style it is Based on. A style that is based on another style marks each value as “Inherited” or “Override”, and its form has Reset to Base. You can also delete a style. See Paragraph styles.

Font Features

This tab shows all 51 OpenType features with previews. To see the features in one of your fonts, select it in Preview with Font. When you select a font, you can also choose which features the editor shows for that font.

If a developer added presets, the tab lists them under Your Saved Presets. See Presets.

Glyphs

This tab shows the glyphs in a font, outside the editor. See The Glyphs Panel.

Options

  • Admin Color Scheme: Choose the colors of the Typography Stylist settings screen. Match Admin Theme uses the colors of your WordPress admin color scheme.
  • Clear Button Confirmation: When Show confirmation when clearing typography features is on, the Clear button in the editor asks you to confirm. It is on by default.
  • Enter Key in Typography Stylist Blocks: When Enter adds a line break inside the block is on, Enter adds a line break. When it is off, Enter starts a new block. It is on by default. Shift+Enter always adds a line break.
  • Font Size Unit for New Content: You always enter font sizes in px. By default, new content writes them in rem, so headings grow when a reader sets a larger default font size in the browser. If your theme changes the root font size, for example html { font-size: 62.5% }, select Write new font sizes in px. The setting applies to new Typography Stylist blocks, new inline font sizes, and new paragraph styles. Content that you saved before keeps its unit. With this setting on, new sizes do not grow with browser zoom. It is off by default. See Responsive and fit-to-width sizing.
  • Archive Page Font Detection: When Check full post content on archive pages (recommended) is on, the plugin checks the full content of the posts on archive pages to find fonts. It is on by default.
  • WordPress Font Library: When Automatically register newly uploaded fonts in the WordPress Font Library (recommended) is on, the plugin also registers new webfont kits in the Font Library. It is on by default. This row shows only on WordPress 6.5 and later.
  • Glyphs Toolbar Button: When Add a Glyphs button to the block toolbar is on, a Glyphs button shows in both editors. It is on by default. Since 2.3.5, the update turns it on one time, also on a site where it was off. If you turn it off after that, it stays off.
  • Paragraph Styles Toolbar Button: When Add a Paragraph Styles button to the block toolbar is on, that button shows in Typography Stylist blocks, and next to the Typography Stylist Features button (the swash T) in other blocks. It is on by default, and the update to 2.3.5 turns it on one time, as for the Glyphs button.

To save these settings, click Save Options.

Two more controls are below the settings:

  • Cache Management: Click Clear Font Cache to clear the font detection cache. Do this if fonts do not load correctly after a change.
  • Editor Tips: Click Show Editor Tips Again to show the editor tips again in this browser.

Accessibility

Disable Word Boundary Warning: When you style part of a word with the inline format, the editor shows a warning. The warning offers to convert the text to a Typography Stylist block. To skip the warning and apply the styling directly, select Skip the warning when applying features to partial words. It is off by default.

To save, click Save Accessibility Settings.

The screen reader class is not on this tab. It is a setting of each Typography Stylist block. See The accessibility model.

Replacement Fonts

This tab lists the mappings from deleted fonts to replacement fonts. Content that uses a deleted font shows the replacement font. The plugin makes a mapping when you delete a font and choose a replacement.

To add a mapping yourself, go to Add New Replacement Mapping. Select a Deleted Font ID and a Replacement Font. Then click Add Replacement.

Export & Import

This tab moves your paragraph styles, presets, the settings on the Options and Accessibility tabs, and the settings of each font (Feature Visibility and variable font axes) to another site. Under Export, choose what to export and click Download export file. Under Import, choose a file and click Preview import. Nothing is saved until you click Import. Only administrators can import. See Export and import.

Help

This tab has a short guide to the inline format, the block, the Enter key, and how to choose fonts.