Parallel builds
Give each shard the same parallel-id to collect its screenshots in one
Vizzly build. Finalize that ID after every shard finishes.
Basic pattern
npx vizzly run "npm test -- --shard=1/3" --parallel-id "build-12345"npx vizzly run "npm test -- --shard=2/3" --parallel-id "build-12345"npx vizzly run "npm test -- --shard=3/3" --parallel-id "build-12345"
npx vizzly finalize "build-12345"You can also set VIZZLY_PARALLEL_ID.
Important rule
Make the parallel ID unique per CI run. Reusing an old one can attach screenshots to the wrong build.
CI guidance
No matter which CI provider you use:
- generate one unique ID for the workflow or pipeline
- pass it to every shard
- always run
finalize, even if some shards fail
finalize tells Vizzly that no more shards are expected.
Check every shard’s upload summary, even when all test jobs pass. An upload failure can leave the shared visual build incomplete without failing the shard’s tests. finalize doesn’t retry missing captures. Fix the upload problem, then rerun with a new parallel ID. See upload troubleshooting.