filter · CSS filters
Convert @import to link (inline_import_to_link)
- Category:
- CSS
- CoreFilters:
- Yes
- OptimizeForBandwidth:
- No
- Risk:
- Generally safe
Converts <style>@import url(...);</style> to <link rel="stylesheet">, enabling other CSS filters (combining, minification) to process the imported stylesheet.
When to use it
- In CoreFilters, the default RewriteLevel: it runs unless you disable it.
- Risk rating on these docs: Generally safe.
Risks
The
CSS filters
page lists no specific risks for this filter.
If a page misbehaves with it, DisableFilters inline_import_to_link turns it off for
the scope you set it in.
Configuration
Enable it in the module configuration, at server, virtual-host or location scope:
Apache
ModPagespeedEnableFilters inline_import_to_linknginx
pagespeed EnableFilters inline_import_to_link;IIS (pagespeed.config)
pagespeed EnableFilters inline_import_to_linkIt is on by default under CoreFilters; to turn it off:
ModPagespeedDisableFilters inline_import_to_link # Apache
pagespeed DisableFilters inline_import_to_link; # nginx
pagespeed DisableFilters inline_import_to_link # IIS
Scoping, ForbidFilters and the thresholds filters read:
Choosing filters
.
Live example
Rewrites a <style> that only @imports into an equivalent <link>.
This filter changes how the page is structured or delivered, not its size, so the example shows a source diff rather than a byte or request reduction.
Frequently asked questions
- What does the inline_import_to_link filter do?
- Converts
<style>@import url(...);</style>to<link rel="stylesheet">, enabling other CSS filters (combining, minification) to process the imported stylesheet. - Is inline_import_to_link enabled by default?
- Yes.
inline_import_to_linkis in CoreFilters, the default RewriteLevel, so it runs unless you turn it off withDisableFilters. - How do I turn off inline_import_to_link?
- Add
ModPagespeedDisableFilters inline_import_to_linkon Apache orpagespeed DisableFilters inline_import_to_link;on nginx. On IIS, addpagespeed DisableFilters inline_import_to_linkto pagespeed.config.
Related filters
- combine_css — Combine CSS
- compute_critical_css — Compute critical CSS
- extend_cache_css — Extend cache for CSS
- fallback_rewrite_css_urls — Fallback CSS URL rewriting
- flatten_css_imports — Flatten CSS @imports
- inline_css — Inline CSS
- inline_google_font_css — Inline Google Fonts CSS
- move_css_above_scripts — Move CSS above scripts
This page is drawn from the inline_import_to_link entry on CSS filters. Every filter in one table: PageSpeed filters.