About this plugin
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.
* 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.
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.
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.
php ). If active on your site, Matcha auto-connects with zero duplicate setup.
"] 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
-
)
- 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