Assets

An asset is a file you have uploaded: an image, a PDF, a video. You upload it once and use it anywhere, and the sites you have used before have probably taught you to expect worse than that.

Find them under Assets in the sidebar.

Uploading

Drag files onto the browser, or use the upload button. You can put them in folders, and you can search — by filename, and by the title and alt text you have given them.

What may be uploaded, and how large, is a site setting. If a file is refused, the message says which rule it broke.

Images

Crop per use, not per upload. The same photograph can be a wide banner on the home page and a square card in a listing without uploading it twice. Set a focal point — the part that must never be cropped out, usually a face — and every size keeps it in frame.

Sizes are named by the site: card, hero, content. Nibble generates each on demand and caches the result, so changing a crop takes effect immediately rather than leaving a stale image behind.

Alt text belongs on the asset, so it travels with the image everywhere it is used. Write it once, and it is right on every page. It is the single most useful thing you can do for people using a screen reader, and it costs one sentence.

Files

Documents, spreadsheets and video work the same way, minus the image tools. A video gets a thumbnail generated automatically.

Using an asset

Wherever an entry has an assets field, choosing it opens this same library — so you pick something that exists rather than uploading another copy. An image placed in rich text is a reference to the asset, not a copy.

That is the part worth remembering: replace the asset and every page using it follows. A new logo is one upload, not a hunt through forty pages.

Before you delete

Each asset shows what is using it. Check that list before deleting; if something is using it, the page loses its image the moment you do.

Deleting an asset moves it to the trash, like an entry, so a mistake is recoverable for as long as the trash keeps it.