← All commands
THE COMMAND REFERENCE

zip

Pack files and folders into a .zip archive.

Last updated

Portable / common

Implementation-level reference; examples are not certified for every installed version.

Overview

zip collects files into one .zip archive and compresses them. The format is understood on every operating system, so it is the usual way to send a folder to someone on Windows. zip adds to an existing archive, and unzip takes things out.

Background

zip is the Info-ZIP program, and the macOS build is Info-ZIP Zip 3.0 with changes by Apple. The tool tested here is that build.

Examples

Make an archive of one file; -q keeps it quiet:

printf data > f.txt && zip -q a.zip f.txt && unzip -Z1 a.zip

Add a folder and everything inside it with -r:

mkdir d && printf x > d/g && zip -qr b.zip d && unzip -Z1 b.zip

Store files without their folder names, with -j (junk the paths):

mkdir d && printf x > d/g && zip -q -j c.zip d/g && unzip -Z1 c.zip

Add a file to an archive that already exists; the list shows both:

printf a > one.txt && printf b > two.txt && zip -q a.zip one.txt && zip -q a.zip two.txt && unzip -Z1 a.zip

Options

-r
Include the contents of folders.

-j
Do not store the folder part of names.

-q
Quiet: no list of files added.

-d
Delete entries from an archive.

Common mistakes

Without -r, zip stores a folder as an empty entry and none of its files. zip adds to an existing archive and does not replace it, so old entries stay; delete the archive first for a fresh one, or use -d to remove entries. The archive does not keep Unix owners, and permissions only as far as the version supports. Names with * or spaces need quotes. A password given with -P is visible to other users in the process list, and the old zip encryption is weak: do not use it for secrets.

Portability

The options above are the same in the Info-ZIP versions on macOS and Linux. Other programs that make .zip files, such as bsdtar and Python's zipfile, have different options. The examples were executed on Info-ZIP Zip 3.0 (macOS build). The Common examples were executed on Info-ZIP Zip 3.0 (macOS build) (see the development guide for the exact check).

References

Original explanations, with upstream documentation for further reading. FreeBSD references are comparison material, not a claim of Apple version equivalence.