Pixault Documentation Help

Migration

The Migration page helps you import images from other services into Pixault.

Migration page

Cloudinary Migration

If you're migrating from Cloudinary, Pixault provides a migration tool that:

  1. Scans your Cloudinary account to inventory all assets

  2. Migrates images and metadata into your Pixault project

  3. Seeds named transforms to recreate your Cloudinary presets

Getting Started

To migrate from Cloudinary, you'll need:

  • Your Cloudinary Cloud Name

  • An API Key and API Secret with read access

Enter these credentials on the Migration page and click Scan to preview the assets that will be imported.

What Gets Migrated

  • All images and videos from your Cloudinary media library

  • Metadata: titles, descriptions, tags, and folder structure

  • Named transformations are converted to Pixault named transforms

After Migration

Once migration completes, your images are available in the Image Library under the same folder structure. Update your application URLs to point to Pixault's CDN:

# Before (Cloudinary) https://res.cloudinary.com/{cloud}/image/upload/w_800/photo.jpg # After (Pixault) https://img.pixault.io/{project}/photo/w_800.jpg

Storage Migration

When you change your storage configuration — such as enabling BYOS, switching between BYOS buckets, or reverting to Pixault-managed storage — you can migrate existing originals to the new location.

From the Dashboard

  1. Go to Storage Settings for your project

  2. Configure your new storage (BYOS or Pixault-managed)

  3. Click Save — if you have existing images, you'll see a Migrate Existing Images prompt

  4. Click Start Migration to begin copying originals

  5. A progress bar shows the migration status in real time

During migration, all image requests continue to work. Pixault reads from whichever store has the image (new store first, then old store).

What Happens

  • Each original is copied from the old store to the new store

  • Image IDs and metadata remain unchanged

  • Once complete, the fallback is removed and all reads go to the new store

  • You can cancel a migration at any time from the Migration page

Bucket Import

If you have pre-existing images in your BYOS bucket — for example, from a previous image service or manual uploads — Pixault can scan the bucket and index them.

From the Dashboard

  1. Go to Storage Settings for your project (BYOS must be configured)

  2. In the Import from Bucket section, click Scan & Import

  3. Pixault scans your bucket and creates metadata for any unindexed images

  4. Progress is shown inline

What Gets Imported

  • Image files in your bucket under the project's key prefix

  • Dimensions are auto-detected from file headers

  • Filename, content type, and size are extracted from the object metadata

  • Objects that already have Pixault metadata are skipped

  • Non-image files are ignored

Bulk Upload via API/SDKs

For images stored outside of cloud storage — on local disk, scattered across URLs, or in non-standard locations — use the Upload API or any of the Pixault SDKs (.NET, JavaScript, Python, PHP).

The upload API accepts any image source and handles all processing. No special import tool is needed — simply iterate over your images and upload them programmatically.

12 March 2026