Connor Clark
Published: Oct 8, 2025
Consider setting font-display to swap or optional to ensure text is consistently visible. swap can be further optimized to mitigate layout shifts with font metric overrides.
How to pass this insight
Set font-display to either swap or optional to pass this insight.
Stack-specific guidance
This insight also offers stack-specific guidance for pages using the following technologies:
Drupal
Specify @font-display when defining custom fonts in your theme.
Magento
Specify @font-display when defining custom fonts.