Skip to main content
The Convertly loader keeps the standard next/image developer experience and rewrites compatible image URLs to the CDN in production.
Create an origin source named site that points to your deployed app’s public HTTPS URL. A normal image such as <Image src="/hero.jpg" width={1200} height={800} alt="..." /> will then use Convertly in production.

Local development

The public CDN cannot fetch localhost, private IP addresses, or private-network origins. Keep localPassthrough enabled during development so local assets render normally. Test optimized delivery on a public preview deployment or HTTPS tunnel.
NEXT_PUBLIC_CONVERTLY_CDN_NAMESPACE is a CDN endpoint’s public URL namespace. Never expose a cvly_... API key in browser code.