### Help & FAQ

> Fast path: Add files, choose any Box Options you need, then start the upload. WarpBox creates one share link for the whole box.

1. Add files: drag files onto the window or use Ctrl + O.
2. Check options: set expiry, password, ZIP download, or one-time download before uploading.
3. Upload: press Ctrl + U or use the Upload button.
4. Share: copy the returned link with Ctrl + L.

#### Keyboard Shortcuts

- Ctrl + O Browse for files.
- Ctrl + U Start the current upload.
- Ctrl + K Copy the full cURL command.
- Ctrl + L Copy the share URL after upload.
- F1 Open this help window.
- Esc Close menus and popups.

#### Common Questions

What is a box?

A box is the temporary share page WarpBox creates after upload. It can contain one file or many files, plus the manifest that records upload status.

Can I password protect uploads?

Yes. Set a password in Box Options before starting the upload. Anyone opening the box must enter that password before downloading protected files.

How does expiry work?

The expiry value is sent with the upload as `retention`. After that period, the server may delete the box and its files according to the running WarpBox configuration.

What does one-time download do?

One-time download tells the backend to treat a file or box as burn-after-read. After a successful download, the link should no longer be reusable.

Can people download everything at once?

Enable ZIP download before uploading. When supported by the backend, the share page offers a single archive for the box.

What happens if one file fails?

The failed row stays red, successful files remain available, and WarpBox marks the failed file in the manifest so you can tell what needs another attempt.

Can I upload from terminal or automation?

Yes. Use the CLI help window for ready-made `curl`, shell, Node.js, Go, and Java examples. Copy command with Ctrl + K.

Are all options server-backed?

Expiry, password, ZIP download, and one-time download are sent to the backend. Box name, custom slug, and API key mode are saved locally until backend support exists.

#### Troubleshooting

Upload button is disabled.

Add at least one file, remove duplicates if prompted, and check Upload Limits for configured box and single-file limits.

Copy failed.

Some browsers block clipboard access outside secure contexts or direct user gestures. WarpBox shows a fallback text box so the link or command can be selected manually.

Shared link opens but download fails.

The box may be expired, consumed by one-time download, password-protected, or removed by server cleanup. Re-upload the file if the box is no longer available.

Large file fails early.

Check Upload Limits first. If the file is inside limits, retry on a stable connection or use the terminal upload flow so the exact server error is visible.