Export and import

Since 2.3.5, you can move your typography settings from one site to another, for example from a staging site to production, or use a house set of styles on each new site. Go to Settings → Typography Stylist → Export & Import.

What can go in the file?

  • Paragraph styles: all styles or the ones you choose. When you choose a style that is based on another style, the other style is added too, and the link is kept.
  • Presets.
  • Options: the settings on the Options and Accessibility tabs.
  • Font settings: the Feature Visibility and the variable font axes of each font.

The order of the font list is not exported. Uploaded font files are not in the file: upload them on the other site first. Adobe Fonts projects and custom font definitions can be added from the file.

How do I export?

  1. Under Export, choose what to export. For each part, choose All or Only the ones I choose.
  2. To add every Adobe Fonts project and font definition on this site, also the ones that no exported style uses, select All fonts on this site. The fonts that the exported styles use are always in the file.
  3. Click Download export file.

How do I import?

  1. If the styles use uploaded font kits, upload those fonts on this site first.
  2. Under Import, choose the export file and click Preview import. Nothing is saved yet.
  3. Read the preview, and make a choice where it asks for one (see below).
  4. Click Import. The result lists what was added, overwritten, and skipped, and the fonts that were not found.

Only administrators can import, because an overwritten style changes every post that uses it.

How are fonts matched?

The file names each font by its family and where it comes from (uploaded, Adobe Fonts, custom definition, or WordPress Font Library), not by a font ID. On import, each font gets one of these results:

  • Found: one font on this site matches.
  • More than one font matches. Choose one. The plugin does not guess.
  • Not on this site. It can be added from the file. This applies to Adobe Fonts projects and custom font definitions.
  • Not found. Upload the font first, or choose a font on this site. If you choose None (use the theme font), the style uses the theme font.

You can change any match to another font on this site.

What happens to a style or preset that already exists?

A style or a preset whose name already exists is skipped, unless you choose otherwise. For a style, choose Add with a new name and type the name, or Overwrite the style on this site. When an overwrite also changes the styles based on that style, the preview lists them. For a preset, choose Add as “Name (2)” (the plugin suggests a free name) or Overwrite the preset on this site. Imported styles get new IDs, so content on this site that already uses a style never changes.

What happens to options and font settings?

The preview lists only the options that have another value on this site. For each one, choose Keep the value on this site or Use the value in the file. The import cannot run until you choose for each option.

For each font, choose Use the settings in the file or Keep the settings on this site. When the matching font on this site has settings of its own, the choice starts on Keep.

To leave out a whole part of the file, clear Import this part.

What does the preview warn about?

Under Check before you import, the preview warns when a style uses OpenType features that Feature Visibility hides for its new font, or variable font axes that the font does not define.

A file that is not valid JSON, is not a Typography Stylist export file, or comes from a newer version of the plugin is rejected, and nothing is saved.

Developers can add their own parts to the file with the typost_export_sections filter. See Export Sections.