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
Inrebuild 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.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.--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.