Skip to main content

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_link

nginx

pagespeed EnableFilters inline_import_to_link;

IIS (pagespeed.config)

pagespeed EnableFilters inline_import_to_link

It 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.

See the before and after, with the source diff →

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_link is in CoreFilters, the default RewriteLevel, so it runs unless you turn it off with DisableFilters.
How do I turn off inline_import_to_link?
Add ModPagespeedDisableFilters inline_import_to_link on Apache or pagespeed DisableFilters inline_import_to_link; on nginx. On IIS, add pagespeed DisableFilters inline_import_to_link to pagespeed.config.

This page is drawn from the inline_import_to_link entry on CSS filters. Every filter in one table: PageSpeed filters.

Search