packages/docs/docs/troubleshooting/font-loading-errors.mdx
When using @remotion/google-fonts, you may encounter timeout errors like:
- A delayRender() "Fetching Inter font {"style":"normal","weight":"100","subset":"cyrillic-ext"}" was called but not cleared after 58000ms.
By default, loadFont() attempts to load all available font weights and character subsets, which can cause timeouts.
Only load the specific font weights and character subsets that your project needs:
import {loadFont} from '@remotion/google-fonts/Inter';
// ❌ Avoid: Loading all weights and subsets
loadFont();
// ✅ Recommended: Load only required weights and subsets
loadFont('normal', {
subsets: ['latin'],
weights: ['400', '700'], // Only load regular (400) and bold (700)
});
If your project uses multiple fonts, centralize font loading in one module and wait until all fonts are loaded before rendering: