Managing Catalog Item Images

Overview

Every item in your catalog can have a product image that appears in estimates, invoices, and the item list. Upload high-quality images (up to 10MB) to help customers visualize what they're buying. Images are stored securely in Vercel Blob storage and served optimized for web viewing.

Uploading Item Images

From the Item List

1. Go to Builder > Items
2. Find the item you want to add an image to
3. Click the image placeholder (camera icon) in the leftmost column
4. The image dialog opens with upload options

Uploading a New Image

1. Click the upload area or drag a file into it
2. Select an image (JPEG, PNG, or WebP - max 10MB)
3. BlueClerk uploads to Vercel Blob automatically with pathname validation
4. Image appears immediately in the preview

Managing Existing Images

Viewing Images

When an item has an image:

• Thumbnail appears in the item list image column
• Click the thumbnail to open the full image dialog
• See large preview of the current image

Replacing Images

1. Open the image dialog for an item with an existing image
2. Upload a new image using the upload area
3. The old image is replaced automatically
4. Previous image is deleted from blob storage

Removing Images

1. Open the image dialog for an item
2. Click "Remove Image" button
3. Confirm deletion
4. Image is removed from blob storage and item record

Image Requirements

• Formats: JPEG, PNG, WebP
• Max size: 10MB per image
• Recommended: Square aspect ratio for best display
• Storage: Uploaded to item-images/{itemId}/ in Vercel Blob

Security

• Upload authorization: Only company admins can upload images for their items
• Pathname validation: Images must be uploaded to item-images/{itemId}/ path
• Company scoping: You can only upload images for items belonging to your company
• Automatic cleanup: When images are replaced or removed, old files are deleted from storage

Where Images Appear

Item images are displayed:

• Item list: Small thumbnail in the leftmost column
• Estimates & invoices: Next to line items (when enabled in template settings)
• PDFs: Included in estimate and invoice PDFs with proper sizing
• Item detail pages: Full-size preview

Tips

• Use clear product photos - Show the item from a helpful angle
• Consistent lighting - Makes your catalog look professional
• Square images work best - They display cleanly in all contexts
• Keep file sizes reasonable - 1-2MB is plenty for web viewing