File groups
Groups are file collections. Use them to organize content in your Uploadcare project. A common use case is to use them in the single content upload or delivery transactions.
For instance, you can create groups when you upload multiple files. For the new uploader this option is turned off by default. For jQuery File Uploader, a new group is automatically created.
When it’s turned on, it stores UUIDs of uploaded files.
You can access file collections via :group_uuid:
:group_uuid is similar to a single file UUID, but it has the file number ~N
at the end. A group can contain up to 1000 files.
A group URL will show a list of individual file URLs with their UUIDs, and index numbers in that group.
Learn more about creating and managing groups.
Accessing single files in a group
Request a specific file in a group by adding /nth/i/, where i is a file index,
starting from 0:
Note, there is no /-/ separator after a group UUID. It’s required for
transformations only.
By the way, you can apply image transformations to the individual files within a group:
You can also group the processed files with the respective operation sequences.
When you request a file by its group URL, it’ll include all operations before
adding it to that group. Adding more operations after /-/ will apply them over
the existing ones.
Get a group as an archive
Getting a group as an archive is done via the archive group processing
operation.
The operation limits are:
- A total size of uncompressed files ≤ 2 GB.
- Processing operations will be discarded. Only original files will be archived.
Here’s how to get an archived file group:
:group_uuid— UUID of a file group you want to get as an archive.:format— the format of that output archive, we supportzipandtar.:filename(optional) — output archive filename.
Note: If the group contains a removed file, the archive operation will fail with a 404 error code.