Media Albums

What are Media Albums?

Media Albums organize your images into named collections that can be linked to PDF templates. When you add Image fields to a template, Mergram looks up image filenames from your spreadsheet against the linked album and renders the matching images onto the PDF.

Albums are team-scoped — every member of your team can access shared albums, upload images, and link albums to templates. This makes it easy to collaborate on image-heavy mail merges like employee ID cards, product catalogs, or event badges.

Creating Albums

1. Go to Assets → Media Albums in the sidebar
2. Click Create Album
3. Enter a name and click Create

You can also create albums directly from the editor’s Media tab — click the album selector, then choose Create new album… at the bottom of the dropdown.

Uploading Media

1. Open an album from Assets → Media Albums, or use the Media tab in the editor
2. Click Upload Image
3. Select one or more PNG or JPEG files from your device

Upload constraints:

Mergram automatically generates a thumbnail (up to 200 × 200 JPEG) for each uploaded image. Thumbnails are used in the browse grid for fast loading without downloading full-resolution files.

Linking Albums to Templates

Each template links to one album at a time. To link an album:

1. Open a template in the editor
2. Open the Media tab in the sidebar
3. Use the album dropdown to select an album

Once linked, any Image field on the canvas will resolve its spreadsheet value against the images in that album. You can switch albums at any time — the template stores the album reference, not the images themselves.

Browsing and Selecting Images in the Editor

The editor’s Media tab shows a grid of thumbnails from the linked album:

• Click any image to copy its filename to the clipboard — paste this into your spreadsheet cells
• Upload new images directly from the sidebar
• Delete images with the trash icon (only when the template lock is acquired)
• Paginate through large albums using the Prev/Next controls

Deleting Media

• Individual images — Click the trash icon on any image card. The image is removed from storage immediately.
• Entire albums — Only owners and admins can delete albums. Deleting an album removes all its images permanently.

Tips

• Use consistent naming conventions — Match image filenames exactly to your spreadsheet data values (employee IDs, product codes, etc.)
• Optimize before upload — Resize images to the approximate display dimensions and compress JPEGs to keep file sizes small
• Use JPEG for photos, PNG for logos — JPEGs are smaller for photographic content; PNGs support transparency and sharp edges
• Organize by project — Create separate albums per project or template rather than one large collection
• Test with previews — Preview a few rows to verify images render at the correct size and position before running a bulk merge

Limitations

• PNG and JPEG only — SVG, GIF, BMP, WebP, and TIFF are not supported
• 10 MB upload limit — Individual images must be under 10 MB
• One album per template — Each template can link to only one album at a time
• No URL-based images — All images must be uploaded to an album
• No folder nesting — Albums are flat; you cannot create sub-albums
• Album deletion requires owner or admin role — Regular members cannot delete albums