Cloudinary Gallery

Tag-based image gallery with lightbox, masonry & pagination

Connect your Cloudinary media library to Framer with zero backend setup. Add a tag to your images in Cloudinary, drop in your cloud name and tag, and get a fully responsive gallery with lightbox, masonry or grid layout, smart image optimisation, and customisable pagination — all powered by Cloudinary's public image list endpoint.

Supports up to 1000 images per tag. For larger libraries, use multiple tags and separate component instances.

Preview: https://cloudinarygallery.framer.website/

Setup

1. Tag your images in Cloudinary Media Library (Select images → Metadata → Edit tags)
2. Enable Resource Lists in Cloudinary Security settings (Settings → Security → Restricted image types → uncheck Resource Lists)
3. Drop the component onto your Framer canvas
4. Enter your Cloud Name and Album Tag in the property panel. Done.

Features

Layouts

• Grid with fixed aspect ratios — 1:1, 4:3, 3:2, 16:9, 9:16, 3:4, 2:3, or fully custom
• Masonry for native aspect ratio layouts
• Cover or contain image fit
• Responsive columns — adjust per breakpoint in Framer's canvas

Image Optimisation

• Every image served with f_auto + q_auto — best format and quality per browser, automatically
• srcSet generated for responsive loading across screen sizes
• Thumbnail width configurable per design
• Lightbox resolution automatically matched to the visitor's screen

Lightbox

• Keyboard navigation ← → Esc
• Swipe gestures on mobile
• Fully themeable — arrow size, colours, border radius, overlay colour
• Smooth open/close animation

Pagination

• Client-side — all images fetched once, no extra requests per page
• Stable grid height so the page counter doesn't jump on the last page
• Compact mode on narrow screens — collapses to ‹ 4 / 20 ›
• Full typography and colour control via a single style object
• Left, centre, or right alignment

Limitations

• Image list is capped at 1000 images per tag. This is a Cloudinary platform limit and cannot be changed from the component.
• Only supports images tagged in Cloudinary Media Library. Folder-based listing is not supported.
• Requires Resource Lists to be enabled in your Cloudinary Security settings — this is off by default.
• Video and raw file types are not supported. Images only.

License

Standard — $19 Use on one personal or client website. Cannot be resold, redistributed, included in templates, component libraries, or shared with third parties.

Agency — $49 Use on unlimited client websites built by your agency. Cannot be resold, redistributed, included in templates, component libraries, or shared with third parties. Each end client receives no license to extract or reuse the component outside the delivered website.

Refund Policy

Due to the digital nature of this product, all sales are final. Refunds are not offered once the component has been accessed or downloaded.

Exceptions: If you experience a technical issue that prevents the component from functioning as described, please reach out before requesting a refund. I'll do my best to resolve it promptly.

Support: alva.sahil@gmail.com