Uploading a site with a ZIP: HubPeople Help

Before you start: prepare your ZIP

The folder structure inside your ZIP becomes your page structure. A file at zip-demo/about-us.html is created at the path /zip-demo/about-us, so use folders to lay out your URLs.

Pages: each .html file becomes a page.
Assets: images (.webp .png .svg .jpeg .jpg .ico .gif), .css, .js, .json, and fonts (.woff2 .ttf) are uploaded as brand assets.
Anything else (for example .txt, .docx, .exe) is unsupported and will be skipped, not deployed.
Size: up to 400MB per file.

If a page already exists at a path, the uploader updates it in place rather than creating a duplicate.

Step 1
Upload

Open Agentic Toolkit → Upload Brand Assets. Drag your ZIP onto the drop zone, or click Browse files to choose it. The supported file types and the size limit are listed in the drop zone.

The uploader on the Upload step, showing the four-step progress bar (Upload, Validate, Confirm, Deploy) and a drag-and-drop zone listing the supported file types and a 400MB per-file limit. — The Upload step: drag and drop, or browse for your ZIP.

Your file appears below the drop zone. Click Upload Files to send it for validation.

The Upload step with a file named zip-demo.zip queued below the drop zone and the Upload Files button now active. — Once a file is selected, it appears as a small chip below the Upload Files button.

Easy to miss: choosing your ZIP does not upload it straight away. It is added as a small chip beneath the Upload Files button, showing its name and size (for example zip-demo.zip 0.01 MB). You still need to click Upload Files to send it for validation. If nothing seems to happen after picking your file, check it is listed there and click the button.

Step 2
Validate and review

The uploader reads every file in the ZIP and shows a summary, for example "21 ready, 3 skipped, 0 failed", followed by a table with one row per file:

File Path & Name: the file as it sits in your ZIP.
Target Path: where it will land on your site.
Action Required: what will happen, such as Create Canvas Page for a new page or Save Asset for an image or stylesheet.
Status: Ready to process, or Skipped (with the reason).
Size: the file size.

The Validate and Confirm screen showing the summary 21 ready, 3 skipped, 0 failed, a select-all bar reading 0 items selected with a Select all 21 items link, and a sortable table with File Path and Name, Target Path, Action Required, Status, and Size columns. — Every file is listed with its target path, the action, and a status.

Sort the columns to check your upload

Click any column header to sort by it. Sorting by Status is the quickest way to pull all the skipped files together so you can see, at a glance, what will not be deployed and why. In the example below the three unsupported files (.exe, .docx, .txt) are grouped at the end, each marked Skipped with the reason "Unsupported file type".

The table sorted by Status so the three skipped files (installer.exe, price-list.docx, readme.txt) are grouped together, each showing the reason Unsupported file type and a Skipped status. A stylesheet shows the Save Asset action. — Sorted by Status: the skipped files are grouped, each showing why it was skipped.

Choose what to process

Use the checkboxes to choose which files to deploy. Tick the box in the header row to select everything on the page, or use the Select all X items link in the blue bar to select every ready file at once. Clear selection resets it. Skipped files cannot be selected, so the count only ever covers the files that can actually be processed.

The table with every row selected, the bar reading All 21 items are selected with a Clear selection link, and the Confirm and Process 21 Assets button now enabled. — With everything selected, the Confirm and Process button shows the count and is ready.

Steps 3 & 4
Confirm and deploy

When you are happy with the selection, click Confirm and Process [N] Assets. The uploader creates the pages, uploads the assets, and links everything up. Larger uploads show live progress; smaller ones finish in moments.

When it is done you see a confirmation, for example "Upload & Processing Complete! 21 files processed successfully", with a transaction list of everything that was deployed. Use Upload more to run another ZIP.

The Deploy step showing a green tick, the message Upload and Processing Complete, 21 files processed successfully, an Upload more link, and a transaction details list of the deployed paths each marked Ready. — The Deploy step confirms what was processed.

Common issues to avoid

Two things catch people out. Both take seconds to check at the Validate step and save a round of back-and-forth later.

Nothing happened, or only some pages deployed? The uploader only processes the files you have selected. It is easy to miss the Select all [N] items link in the blue bar and tick only a row or two by mistake. Before confirming, check the number on the Confirm and Process [N] Assets button matches what you expect to deploy.

A page did not turn out as expected? Check the Status column before confirming. Sort by Status so every Skipped (and any Failed) row groups together, then read the reason next to each one. If a file was skipped or flagged here, it was never going to deploy correctly, so spotting it now is much quicker than tracking it down after the fact.

Tip: Re-uploading a path updates the page in place rather than creating a duplicate, so if you do spot a problem you can fix the file and simply upload again.