Skip to main content
Install the CLI and configure access before uploading. Start with a local dry run to inspect the group and destination choices.
A naming pattern groups matching images within each directory. Use the named captures key and variant. The name original marks the source explicitly. Non-matching files are skipped when a pattern is supplied. Without a pattern or manifest, each regular file is uploaded individually.

Rebuild conversions

In rebuild mode the CLI sends one file per group. It selects the marked original or measures the candidates and picks the one with the largest resolution. Groups with conflicting aspect ratios or a tie for the largest resolution require an explicit original. Studio generates the conversions configured for the destination. See image conversions.

Keep conversions

Use a manifest to preserve named conversions and assign display roles. Each line is one complete JSON object, with paths relative to the import directory.
The source and its conversions are published together under one image version. The named conversions appear with the import- prefix. You can assign thumbnail and preview separately, including to intentionally different crops. Each preserved bundle supports one source and up to 12 conversions within the server’s ordinary upload limit. Use rebuild mode for larger source files when you want resumable chunks or direct S3 Multipart. Repeat the same import with the same inputs after a failed transfer. Studio resolves the same folders and uses stable upload keys to avoid creating copies. The CLI reports failed groups and exits nonzero so a script can detect incomplete work.

Import an ordinary folder

Without image grouping, every regular file is one source. The relative directories become folders beneath the optional destination parent.
Omit --parent to use the workspace root. Check the upload policy’s allowed types and file-size limits. Keep the source stable until all groups finish. See Manifest format and limits, resumable and S3 transfers and automation output for the corresponding contracts.