Docs/CDN Mode

CDN Mode

Understand when to keep WordPress images on a CDN instead of downloading them locally in PhantomStudio.

CDN Mode

Use CDN mode when your WordPress site already serves media from a CDN plugin or CDN hostname and you want PhantomStudio to keep those image URLs remote.

In CDN mode, PhantomStudio does not download and localize WordPress images into your project. That keeps builds lighter and avoids duplicating assets that are already being optimized and delivered elsewhere.

Turning It On

Open Site ▾ › WordPress › Content. Under Image Handling, choose Keep images on existing CDN (CDN mode) or Download & optimize locally (local mode), then click Save Settings. The choice appears once the site has media.

When To Use CDN Mode

Choose CDN mode when:

  • your WordPress site already rewrites media URLs to a CDN
  • you want to keep images remote instead of bundling them into the repo
  • faster builds and a smaller repository matter more than local image copies

When To Keep Local Mode

Keep local mode when:

  • you want images committed with the project
  • you want PhantomStudio's current local image download and mapping flow
  • you do not already have a CDN serving WordPress media

PhantomStudio does not manage CDN plugins for you, but it can detect common CDN-served media URLs.

Detection

If PhantomStudio detects a known CDN pattern in your WordPress media URLs, Image Handling shows the provider next to Keep images on existing CDN (for example "Jetpack CDN detected"). In CDN mode, the media count also says "via" that provider.

Next Steps