Upload or change a book cover

Every book in your catalogue can have a cover image. Patrons see covers in browsing, search, and on the book detail page.

Where covers come from

• Bulk ISBN import: covers auto-fetch from Google Books or Open Library
• Manual entry: upload an image or paste a URL
• Re-edit any time: Catalog → find book → Edit → Cover

Upload requirements

• File types: JPEG, PNG, WebP, GIF, SVG
• Max size: 5MB
• Recommended dimensions: 400×600 pixels (2:3 aspect ratio, like a book cover)
• Square or wider images get letterboxed; tall images are fine

Where covers are stored

Shelfwise uses Supabase Storage. Your covers live in your project's "book-covers" bucket and are served via a CDN — patrons load them instantly.

Replacing a cover

• Catalog → find book → Edit
• Cover section → click Replace
• Upload a new image or paste a URL
• Save

The old cover is automatically removed from storage.

Removing a cover entirely

If you remove the cover, the book displays a coloured placeholder with the first 2 letters of the title. The placeholder uses your brand colour.

Troubleshooting

• "Bucket not found" — The storage bucket may not be configured. Contact support — we'll provision it.
• Cover not showing for patrons — Hard-refresh your browser (Cmd-Shift-R or Ctrl-Shift-R) to bypass cache.
• Upload fails for one image — Check the file size (5MB cap) and the MIME type. Convert to JPEG or PNG if it's something exotic.