Skip to content

Media and emoticons

Every image, video, PDF or other file your site uses lives in the media library. Open Media to see it: every file, newest first, as a tile with a preview (or its file type, for anything that isn’t an image), its size, and its address.

At the top of Media, choose a file, optionally pick a folder for it (or type a name under …or a new folder to make one), and select Upload.

You can also upload from anywhere you pick a file, such as an image field in the page editor or the image button in the article editor. Select Browse…, then Upload in the media library window. The new file is picked straight away.

Each file gets a permanent address beginning /media/. Select Copy on a tile to copy its full address, for pasting somewhere else.

The site works out what a file is from its contents, not its name, and gives it the right ending: a PNG named photo.jpg is stored as a .png. Each kind of file has a size limit:

Kind Up to
Images (JPEG, PNG, GIF, WebP, AVIF) 8 MB
Videos (MP4, MOV, WebM) 50 MB
PDFs 25 MB
SVG images and HTML pages 2 MB
Anything else 25 MB
  • SVG and HTML files can contain script, so only admins can upload them. Even then, any script in them never runs when they’re opened from the site.
  • HEIC photos (the iPhone default) can’t be used on the web. Export the photo as a JPEG first.
  • Other files, such as Word documents or zip files, are always downloaded when someone opens their link, rather than shown in the browser.

Before an image leaves your computer, your browser shrinks it to at most 2048 pixels wide and converts it to WebP. A smaller image is never enlarged. Big phone photos become a fraction of their size, which keeps your pages quick and uploads fast on a slow connection.

  • Uploading on the Media page stores one resized copy.
  • Uploading from the media library window in an editor also stores smaller copies (512 and 1024 pixels wide, where the original is bigger than that), so the site can send phones a smaller image. They appear in the library as separate files, with the width at the end of the name.
  • SVG images, videos and other files are uploaded exactly as they are.

Only the resized copy is kept, so keep your own originals.

Folders help you find things; they don’t change anything else. Moving a file between folders never changes its address, so nothing that uses it breaks.

  • To see one folder, select its name above the files. All shows everything, and Unfiled shows files that aren’t in a folder.
  • To move a file, choose a folder from the menu on its tile.
  • To create, rename or delete folders, open Manage folders. Deleting a folder keeps its files: they become Unfiled.

Uploading while you’re looking at a folder puts the new file in that folder.

Your emoticons also appear here, in a locked Emoticon folder. You can use them as ordinary images, but you manage them on the Emoticons page.

To swap a file for a new version without changing its address (a new logo, or a corrected PDF), select Replace on its tile and choose the new file. After you confirm, every page that uses the file shows the new one.

The new file must really be the same type as the old one, judged by its contents: a PDF for a .pdf, a WebP image for a .webp. The same limits apply as for uploading. To change the type, upload a new file and update the places that use it. Replacing doesn’t resize images the way uploading does.

Select Delete on its tile and confirm. The file is gone for good, and anything that still uses it (a page, an article, a person’s photo) shows a broken image or link. Check before you delete.

Emoticons are small images that you and your readers can put in the middle of text, like emoji, at the height of the text around them. They’re picked from the emoticon button in the editor toolbar, and readers with accounts can use them in comments. A new site has none.

Managing emoticons needs the publisher or admin role. Open Emoticons (under Design).

Under Add an emoticon:

  1. Choose an Image. Any image your browser can open will do: it’s converted to a 200 × 200 PNG, scaled to fit and centred on a transparent background, never cropped.
  2. Give it a Slug: lowercase letters, numbers and single hyphens, such as dragon-tail. It’s the emoticon’s name, shown as :dragon-tail:.
  3. Pick a Category, or type a new one under …or a new category. Categories group emoticons in the editor’s picker.
  4. Select Upload.

Select Edit on an emoticon to change its slug or category, then Save. Renaming is safe: wherever the emoticon has already been used keeps working.

Delete removes the emoticon for good, and wherever it has already been used shows a broken image instead. Only delete one you’re sure nobody has used.

Use Manage categories to create, rename or delete categories. Deleting a category keeps its emoticons; they become Uncategorised.