Nuxt Image supports multiple providers for high performances.
Providers are integrations between Nuxt Image and third-party image transformation services. Each provider is responsible for generating correct URLs for that image transformation service.
Nuxt Image can be configured to work with any external image transformation service. Checkout sidebar for list of preconfigured providers.
If you are looking for a specific provider that is not already supported, you can create your own provider.
Nuxt Image will automatically optimize <nuxt-img>
or <nuxt-picture>
sources and accepts all options for specified target, except for modifiers that are specific to other providers.
The default provider for Nuxt Image is ipx or static (for target: static
). Either option can be used without any configuration.
Learn more about Nuxt deployment targets
Images should be stored in the static/
directory of your project.
For example, when using <nuxt-img src="/nuxt-icon.png" />
, it should be placed in static/
folder under the path static/nuxt-icon.png
.
Image stored in the assets/
directory are not proccessed with Nuxt Image because those images are managed by webpack.
For more information, you can learn more about the static directory here.
Using default provider, you can also optimize external URLs. For this, you need to add them to domains
option.
You can set default provider using NUXT_IMAGE_PROVIDER
environment variable. Providers below, are automatically detected: