Skip to main content

Warns against using deprecated fonts in config/settings_data.json.

Anchor to Validation on deprecated fontsValidation on deprecated fonts

You'll get a warning if you use a deprecated font in your settings_data.json schema settings. To resolve the warning, use a handle for a font from Shopify's library.

Anchor to ✗ Fail✗ Fail

In the following example, the deprecated font helvetica_n4 is used in the live current settings, in a preset's top-level settings, and in a deeply nested preset block setting.

{
"current": {
"heading_font": "helvetica_n4",
"blocks": {
"block-id-1": {
"type": "header",
"settings": {
"heading_font": "helvetica_n4"
}
}
}
},
"presets": {
"Default": {
"heading_font": "helvetica_n4",
"body_font": "agmena_n4"
}
}
}

This example is not exhaustive. The check applies to any string value in config/settings_data.json that matches a deprecated font handle.

Anchor to OptionsOptions

The following example contains the default configuration for this check:

DeprecatedFontsOnSettingsData:
enabled: true
severity: warning
ParameterDescription
enabledWhether this check is enabled.
severityThe severity of the check.

Anchor to Disabling this checkDisabling this check

Disabling this check isn't recommended because using deprecated fonts in settings_data.json may lead to unexpected behavior in future Shopify updates. These deprecated font settings are being phased out in favor of the new font system, and themes that continue to use them may experience styling issues or broken functionality when the deprecated features are eventually removed.

Was this page helpful?