Matcha Gallery – AI Photo Wall, Masonry & Portfolio Studio

Matcha Gallery is the next-generation WordPress gallery plugin built for photographers, visual artists, designers, and eCommerce portfolios. It combines a state-of-the-art Matcha Studio visual editor with Google Gemini AI vision to automatically tag photos, generate SEO alt-text, calculate color palettes, and create stunning responsive photo walls.

Matcha Gallery produces clean, modern HTML5/CSS3 output with zero jQuery dependencies and fast page load times (<15KB frontend runtime).

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.
* AI Vision & Metadata Generator: Powered by Google Gemini AI. Automatically generates ADA-compliant alt text, human-readable titles, descriptive captions, and SEO keyword taxonomy.
* 6 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).
* Pinwheel Spiral — Center hero spotlight with surrounding spiral thumbnails.
* Bento Showcase — Modern tech-style hero spread.
* Justified Rows — Flickr-style edge-to-edge justified rows.
* 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.
* 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