Assets

An asset is any file you store against your books and people: a cover image, a manuscript, an audiobook, a promotional graphic. Pubblish keeps every file in one place and sorts it into a category. You can tag it, link it to a title, and download it again later. This guide shows you how to upload files, organize them, and get them back out.

Where your assets live

There are two ways to reach your files.

  • The Assets library, under Media in the sidebar, shows every file across your whole catalog. Use it to search, filter, and download in bulk.
  • Each title, contributor, person, and publisher imprint has its own Assets area on its edit page. This shows only the files linked to that one record.

You upload files on a record’s Assets area. The library is for browsing and managing what you already have.

The Assets library showing the storage meter, search and filter controls, view toggles, and a grid of asset cards

Uploading files

You add files from a record’s Assets area, not from the main library.

  1. Open a title, then click the Assets tab. (For a person, contributor, or imprint, open the record and scroll to its Assets section.)
  2. Drag one or more files onto the drop zone, or click it to pick files.
  3. Each file uploads and appears as a card.

Pubblish sorts each upload into a category automatically. If the category is wrong, change it with the category dropdown on the card. Every file you upload here is linked to the record you uploaded it on.

You must save a new title before its Assets tab opens. Until then the tab is disabled.

Categories and tags

Categories and tags do two different jobs. Use both.

A category says what kind of file it is. Categories come from a fixed list, grouped by media type:

  • Images: Front Cover, Back Cover, Audiobook Cover, Full Wrap, Spine, Author Photos, Interior Samples, Promotional, Logos
  • Documents: Manuscript, Proof, Contract, Marketing Materials, and private paperwork such as Identity Documents, Tax Forms, and Banking
  • Audio: Full Audiobook, Sample Clips
  • Video: Trailer, Author Interview, Behind the Scenes

You set a card’s category from the dropdown on the card.

A tag is your own label. Add tags like UK, Instagram, or 3D Mockup to group files your own way, across categories. Click the + button in a card’s tag row to add one. Click the × on a tag to remove it.

Use a category to answer “what is this file?” Use a tag to answer “which of my files belong together?” A cover is always in the Front Cover category, but you might tag some covers UK and others US.

Linking assets to titles and editions

An asset links to a title when you upload it on that title’s Assets tab. This is how covers, manuscripts, and promotional files stay attached to the right book.

Editions do not have their own upload area. All formats of a book share the title’s files. The cover shown on each edition is the title’s primary Front Cover.

Setting the primary asset

Each card has a star button. Click it to make that file the primary asset for its category on that record.

The primary asset is the one Pubblish uses when it needs a single file from that category. For a title, the primary Front Cover is the cover shown on the title and its editions.

You can hold several files in one category, but only one can be primary at a time. Setting a new primary clears the star from the old one.

To delete every other file in the category, open a card’s More actions menu (the button) and choose Delete others. This deletes every other file in the same category on that record and keeps the one you chose.

Author photos

A person, a contributor, and each contributor row on a title show a round photo slot. This is a shortcut for setting a headshot without opening the full asset area.

Click the photo slot, or drop an image on it, to set the photo. It becomes the primary Author Photos asset for that person or contributor. On an imprint the same slot sets the primary Logos image. Click the × on the photo to remove it.

Replacing a file and previous versions

To swap the file inside a card without losing its category, tags, or primary status, open the card’s More actions menu () and choose Replace. Pick the new file. The card keeps everything except the file itself.

When you replace a file, Pubblish keeps the old one as a previous version. Previous versions appear in the same More actions menu, listed as v1, v2, and so on. You can download any previous version.

Previous versions are download-only history. There is no button to restore an old version in place. To go back to an earlier file, download it, then use Replace to put it back.

Downloading assets

To download one file, open its More actions menu () and choose Download.

To download several at once:

  1. Go to the Assets library.
  2. Select the files (each card has a checkbox).
  3. Use the bar that appears at the top:

  4. Download saves each selected file on its own. When you select more than one, this button reads Download (Individual).

  5. Download ZIP appears once you select more than one file. It packages them into a single ZIP archive.

A ZIP download is capped at 200 files or 500 MB. If a selection is over either limit, the download is refused. Select fewer files and try again.

Supported file types

Pubblish accepts a wide range of formats across four media types:

Media type Formats
Images JPG, PNG, WebP, GIF, TIFF, SVG, plus design files (PSD, AI, InDesign, EPS, Affinity)
Documents PDF, Word (DOCX), EPUB, HTML
Audio MP3, M4A, M4B, WAV, FLAC
Video MP4, MOV, WebM

Each format has its own size limit. Everyday images are capped at 20 MB. Design file formats such as PSD and InDesign allow up to 500 MB. If a file is too large, the upload is refused.

A Word document (.docx) card carries an extra Quick Convert action in its More actions menu, which sends the file to a conversion. See Conversions.

A note on private files

Some document categories hold confidential paperwork: Identity Documents, Tax Forms, Banking, Contract, and Correspondence. A team member with the read-only viewer role cannot see or download files in these categories. Editors and admins can.

Storage

If your plan sets a storage limit, a Storage meter shows at the top of the Assets library with how much you have used. When it fills up, delete files you no longer need, or add storage, to upload more.