Uploading files

On this page

Drag files onto the page or press Upload. There is no form to fill in first: the file lands in the folder you have open, and its category is read off the file. Both are editable afterwards.

WhereDashboard, Assets

Four ways to start

The Upload button above the library on Assets (opens in a new tab). It takes as many files at once as you like.
Drop files anywhere on the page, not just on the dashed rectangle.
Drop onto a folder in the library, and the file lands there instead. While you drag, the bar along the bottom says Drop to upload into and the name of the place it will go.
The Upload folder button, which rebuilds a folder and its structure in the library. Shown only to members who may make folders.

Where the file lands

Files go into the folder you have open. Dropping onto a folder overrides that, and dropping onto All files puts them at the top level. If you are not allowed to upload into the folder you dropped on, the file lands in the folder you were already in. See Folders, categories and tags.

The category it is filed under

One category is guessed from the file, and you can correct it afterwards in the file's own panel. It is always a built in category.

Filed under	When
Fonts	A font: woff, woff2, ttf or otf.
Other	Any video or audio file.
Logos	The word logo somewhere in the file name.
Icons	The word icon somewhere in the file name.
Photography	Any other image, including SVG.
Documents	A PDF, or a doc, docx, pages or odt file.
Presentations	A ppt, pptx, key or odp file.
Other	Everything else.

What may be uploaded

Almost anything: images, SVG, PDFs, video, audio, fonts, office documents, archives. Two things are refused:

Web pages and scripts

HTML, XHTML, JavaScript and XML files are refused with That kind of file cannot be stored here.

Empty files

A file of zero bytes, which is usually a folder dropped on the page.

Images, PDFs, video, audio and plain text open in the library. Office documents, fonts and archives are stored, but you download them to open them. See Editing a file.

How large a file may be

There is no per file limit. There is a storage quota per brand, counting the files in the library, the versions kept when a file is replaced, and anything in the trash.

Plan	Storage
Free	512 MB
Pro	25 GB
Business	250 GB

Over the quota, an upload is refused with Storage limit reached. Upgrade your plan for more space. See The trash, storage and the quota and Plans and limits.

A frozen brand takes no new files

If your plan no longer covers the number of brands you have, the brands you did not keep active are frozen and refuse new uploads. They still read and export exactly as before, and nothing has been deleted. See What a downgrade freezes.

Previews for video and PDF

An image is its own thumbnail. A video gets a frame from near the start, and a PDF gets its first page. A preview can fail without the upload failing. PDFs over 64 MB, office documents, presentations and fonts get no preview.

A file the library already has

A file already in the library is held rather than sent. It is marked Already here in the upload panel, with Same bytes as and the name of the file it matches and the folder it sits in. The top line of the panel reads 1 already in the library, waiting on you. Nothing has been uploaded, and the choice is yours:

Upload anyway

Send it, as a second file.

Skip

Drop it and take it off the list.

Upload all anyway / Skip all

The same two decisions for every held file at once.

The upload panel

The panel in the corner reports the run and keeps going while you move around the dashboard. It opens itself when a run starts and collapses to one line with Hide. The top line reads Uploading 3 of 8, 41%, and when nothing is left it becomes a report: files uploaded, files failed, or both.

Waiting

Queued behind the files ahead of it.

Checking

Being looked up in the library.

Already here

A duplicate, waiting on your decision.

A percentage

Being sent, with its own bar.

Done

In the library.

Failed

With the reason under it.

A run with no failures closes itself four seconds after it finishes. A run with a failure stays until you dismiss it.

Closing the tab stops the upload

The browser asks before you leave with anything unfinished. There is no resuming afterwards: start the file again.

Uploading a whole folder

Press Upload folder and choose the folder, or drag the folder onto the page. Either way the structure is rebuilt in the library, and every file lands in the folder it came from.

Depth

Folders go 4 deep, counted from where the drop lands. Anything deeper is filed in the deepest folder that could be made, and you are told: 1 file was filed higher up: Folders go 4 deep, so it went into ...

Count

Up to 2000 files per drop. Anything past that is cut, with Only the first 2000 files were taken.

Operating system files

.DS_Store, Thumbs.db, desktop.ini, anything beginning ._ and anything under __MACOSX are skipped.

Folder names

Cut at 60 characters.

Unreadable entries

Skipped, rather than failing the whole drop.

A dropped folder in an older browser

Some browsers hand over a dropped folder as a single entry with no contents. You get That looks like a folder. Use Upload folder, or drop it again in a browser that reads folders. The button works either way.

What you need to be allowed to do

Upload files, and rename, edit, duplicate and refile them

asset:write

Make and change folders and categories, upload a whole folder, and set who may use each one

asset:folders

Without Upload files, and rename, edit, duplicate and refile them the Upload button is not shown. Upload folder needs Make and change folders and categories, upload a whole folder, and set who may use each one as well; without it the button is not shown, and a dropped folder is refused with You cannot make folders in this brand. A single folder can also require a higher role to upload into. See Roles and Custom roles.

Failures and what to do

That looks like a folder.

Use Upload folder instead.

That file is empty. A folder dropped on the page arrives like this: use Upload folder instead.

The file is zero bytes.

That kind of file cannot be stored here.

It is an HTML, JavaScript or XML file.

Storage limit reached.

Empty the trash, delete what is not needed, or upgrade.

This brand is frozen...

Your plan does not cover this brand. Nothing has been deleted. Make it active again, or upgrade.

You cannot make folders in this brand.

You need Make and change folders and categories, upload a whole folder, and set who may use each one to upload a folder.

You cannot add to "...".

You may not make folders inside that folder: it requires a higher role than yours.

You cannot upload into "...".

That folder requires a higher role than yours.

That folder is no longer there.

The folder was deleted while the drop was being read. Try again.

Could not start the upload.

Try again.

Upload canceled.

The upload was stopped.

The file was uploaded but could not be saved to the library.

The file is not in the library. Upload it again.

Unauthorized / Forbidden

Your session ended, or you no longer have Upload files, and rename, edit, duplicate and refile them in this brand.

A failed upload leaves nothing behind

A file that failed is not in the library and is not counted against your storage quota.

After the upload

Each file records who uploaded it and when, and the upload appears under Assets in the activity log as Uploaded asset with the file name.
The name, the categories, the tags and the folder are all editable. See Editing a file.
Before deleting a file, check Where a file is used.

PreviousWhat a reader can do on a published page NextFolders, categories and tags

Still stuck? Write to hello@stylehub.cloud and say which page you were on.