Matcha Gallery – Image Gallery, Photo Gallery & Masonry for WordPress

Matcha Gallery is a free, lightweight image gallery and photo gallery plugin for WordPress with 7 responsive layouts: Grid, Masonry, Mosaic, Bento, Justified, Lookbook, and Cinema Reel.

Create beautiful masonry galleries , portfolio galleries , and photo walls in seconds with the built-in Matcha Studio visual editor. Includes AI-powered auto-tagging (Google Gemini & OpenAI), realistic picture framing, client proofing, color palette filtering, and a native Gutenberg block.

Built for photographers, visual artists, designers, and eCommerce portfolios. Zero jQuery dependencies, under 15KB frontend runtime, and 100/100 PageSpeed scores.

Live Demo & Documentation | Support & Help

Key Highlights

• Matcha Studio Visual Editor: A distraction-free, 3-panel visual workspace inspired by Figma. Customize layouts, picture framing, drop shadows, and matting with real-time WYSIWYG preview.
• Interactive 3D Spatial Depth Tilt (Pro): Hardware-accelerated cursor perspective tilt with realistic specular glare reflections and dynamic card elevation.
• Atmospheric Aura Dual-Layer Bloom (Pro): Rich ambient lighting halo with focal-point bloom synchronized with image color palettes.
• AI Vision & Metadata Generator: Powered by Google Gemini AI. Automatically generates ADA-compliant alt text, human-readable titles, descriptive captions, and SEO keyword taxonomy.
• 7 Algorithmic Layout Blueprints: Classic Grid — Uniform aspect ratio with responsive column presets.
• Pinterest Masonry — Fluid cascading heights preserving native aspect ratios.
• PhotoBlocks Mosaic — Custom geometric tile spans (1×1, 2×1 wide, 1×2 tall, 2×2 hero).
• Bento Showcase — Modern tech-style hero spread.
• Justified Rows — Flickr-style edge-to-edge justified rows.
• Lookbook Duet — 2026 editorial magazine layout with staggered cadence.
• Cinema Reel — 16:9 widescreen horizontal runway with smooth momentum scroll-snap.

1-Click ✨ Smart Fill: AI analyzes image aspect ratios across your entire collection and automatically assigns the optimal geometric tile layout with one click. In-Frame Pan & Zoom Cropping: Interactive 2D target reticle and zoom slider (1.0x to 2.5x) to set pixel-perfect focal framing without cutting off heads or subjects. Realistic Picture Framing & Matting: 5 gallery-grade picture frames ( White Matting, Slim Black Metal, Natural Oak Wood, Brushed Gold Brass, Glass Float ) with customizable 0–32px matting margins. Multi-Section Gallery Chapters: Organize a single gallery into tabbed chapters (e.g. Ceremony, Reception, Portraits or Living Room, Bedroom, Kitchen ) with smooth animated switching. AI Color Swatches & Live Filter Toolbar: Instant color dot filter buttons extracted by AI, plus live keyword search and animated category filter pills. Client Proofing & Shoppable Portfolios: Visitors can favorite photos with heart icons ( 🤍 → ❤️ ) and export clean selection lists, or click glassmorphic Buy / Shop Now buttons. 1-Click 📷 Export Wall & Client Proofing Sheet: Download a 2x crystal-clear PNG snapshot of your arranged gallery wall, or print a branded client proposal sheet with dimensions and pricing. WordPress 7.0 Connectors Ready: Seamlessly bridges with the native WordPress 7.0+ AI Connectors API ( Settings > Connectors ) and environment credentials ( wp-config.php ). If active on your site, Matcha auto-connects with zero duplicate setup. Gutenberg Block & Shortcode: Embed galleries seamlessly via the native [matcha_gallery id="..."] shortcode or the dedicated Gutenberg block.