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.

Third-Party Services

This plugin can optionally integrate with the following external third-party AI provider services to generate image alt-text, titles, captions, keyword tags, color swatches, and focal cropping coordinates. All AI features are entirely optional and require you to provide your own API key in the plugin settings.

• Google Gemini AI API (Google LLC)

  • What it is used for: Analyzes uploaded image attachments to generate descriptive alt-text, titles, captions, keyword tags, dominant color palettes, and focal point coordinates.
  • What data is sent and when: Image URLs or base64 image data are sent over secure HTTPS only when you explicitly click “⚡ AI Enhance”, click “Generate AI Metadata” in the WordPress Media Library, or enable the “Auto-generate on upload” option in settings.
  • Privacy Policy: https://policies.google.com/privacy
  • Terms of Service: https://ai.google.dev/terms

• OpenAI API (OpenAI, Inc.)

  • What it is used for: Vision-based image metadata generation, keyword tagging, and alt text analysis for users configuring an OpenAI API key.
  • What data is sent and when: Image data and text prompts are sent over secure HTTPS only when triggered by user request in the editor or media library.
  • Privacy Policy: https://openai.com/policies/privacy-policy/
  • Terms of Service: https://openai.com/policies/terms-of-use/

• OpenRouter API (OpenRouter)

  • What it is used for: Multi-model AI routing allowing users to connect alternative vision models using an OpenRouter API key.
  • What data is sent and when: Image data and prompt requests are sent over secure HTTPS only when triggered by user request.
  • Privacy Policy: https://openrouter.ai/privacy
  • Terms of Service: https://openrouter.ai/terms