Title: Matcha Gallery – AI Photo Wall, Masonry & Portfolio Studio Author: WPMatcha Published: 19 Setember 2026 Last modified: 07 Otover 2026 --- Search plugins ![](https://ps.w.org/matcha-gallery/assets/banner-772x250.png?rev=3703455) ![](https://ps.w.org/matcha-gallery/assets/icon.svg?rev=3703453) # Matcha Gallery – AI Photo Wall, Masonry & Portfolio Studio By [WPMatcha](https://profiles.wordpress.org/wpmatcha/) [Download](https://downloads.wordpress.org/plugin/matcha-gallery.1.0.3.zip) * [Details](https://lmo.wordpress.org/plugins/matcha-gallery/#description) * [Reviews](https://lmo.wordpress.org/plugins/matcha-gallery/#reviews) * [Installation](https://lmo.wordpress.org/plugins/matcha-gallery/#installation) * [Development](https://lmo.wordpress.org/plugins/matcha-gallery/#developers) [Support](https://wordpress.org/support/plugin/matcha-gallery/) ## Description **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](https://wpmatcha.com/wordpress-plugins/matcha-gallery-pro/) | [Support & Help](https://wpmatcha.com/contact/) ### 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](https://policies.google.com/privacy) - **Terms of Service:** [https://ai.google.dev/terms](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/](https://openai.com/policies/privacy-policy/) - **Terms of Service:** [https://openai.com/policies/terms-of-use/](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](https://openrouter.ai/privacy) - **Terms of Service:** [https://openrouter.ai/terms](https://openrouter.ai/terms) ## Screenshots [⌊Matcha Studio Editor — 3-Panel visual workspace with dark studio theme and realistic wall preview.⌉⌊Matcha Studio Editor — 3-Panel visual workspace with dark studio theme and realistic wall preview.⌉[ Matcha Studio Editor — 3-Panel visual workspace with dark studio theme and realistic wall preview. ## Blocks This plugin provides 1 block. * Matcha AI Smart Gallery AI-powered filterable image gallery with grid and masonry layouts. ## Installation 1. Upload the `matcha-gallery` folder to your `/wp-content/plugins/` directory, or install directly through **Plugins Add New** in your WordPress dashboard. 2. Activate the plugin through the **Plugins** menu in WordPress. 3. Navigate to **Matcha AI AI Settings** and enter your free Google Gemini API key( or OpenAI key). 4. Go to **Matcha AI All Galleries** and click **Add New Gallery** to open the Matcha Studio visual editor. 5. Add photos, customize your layout and framing, and copy your shortcode `[matcha_gallery id="..."]` into any page or post. ## FAQ ### Do I need a paid API key to use the AI features? No! Google Gemini offers a generous free tier (up to 15 requests per minute) that is completely free of charge. You can generate a free API key at [Google AI Studio](https://aistudio.google.com/). ### Can I use Matcha Gallery without AI? Yes, absolutely! All 6 layouts, picture framing, matting, multi-section chapters, lightboxes, and shortcodes work 100% out of the box without configuring an API key. ### Will AI overwrite my existing image alt text? By default, no. Matcha Gallery only enriches images with missing alt text or captions. You can toggle “Overwrite existing metadata” in Settings if you wish to re-generate everything. ### Does Matcha Gallery work with WordPress 7.0 AI Connectors? Yes! Matcha Gallery includes a Smart Hybrid bridge. If your site is running WordPress 7.0+ with an active AI connector configured in Settings > Connectors (or via wp- config.php), Matcha auto-detects it. You can also provide a direct API key (such as a 100% free Google Gemini Flash key) anytime. ### Is Matcha Gallery fast and lightweight? Yes! The frontend runtime is under 15KB of vanilla JavaScript with zero jQuery or external framework dependencies. It uses native CSS Grid and Flexbox for maximum rendering speed and 100/100 Google PageSpeed scores. ### How do I embed a gallery into a page? You can insert the native **Matcha Gallery** Gutenberg block, or paste the shortcode`[ matcha_gallery id="123"]` into any block, page builder (Elementor, Divi, Beaver Builder), or widget area. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Matcha Gallery – AI Photo Wall, Masonry & Portfolio Studio” is open source software. The following people have contributed to this plugin. Contributors * [ WPMatcha ](https://profiles.wordpress.org/wpmatcha/) [Translate “Matcha Gallery – AI Photo Wall, Masonry & Portfolio Studio” into your language.](https://translate.wordpress.org/projects/wp-plugins/matcha-gallery) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/matcha-gallery/), check out the [SVN repository](https://plugins.svn.wordpress.org/matcha-gallery/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/matcha-gallery/) by [RSS](https://plugins.trac.wordpress.org/log/matcha-gallery/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.3 * UI: Figma-inspired Matcha Studio workspace refresh — clean separated panels, high-contrast controls, and fluid responsive canvas preview. * Fix: High-specificity chapter tab CSS resets to prevent theme styling bleeds on frontend galleries. * Fix: Hardened REST API permissions with granular per-post and per-attachment authorization callbacks. * Pro: Full support for Interactive 3D Spatial Depth Tilt and Atmospheric Aura dual-layer lighting bloom with Matcha Gallery Pro. * Maintenance: Upgraded SortableJS to stable 1.15.7 and optimized frontend script bundles. #### 1.0.2 * Feature: Smart Hybrid WordPress 7.0+ AI Connectors Bridge (`Settings > Connectors`)— auto-detects site-level OpenAI and Google Gemini credentials with fallback to free direct keys. * Feature: Lookbook Duet layout blueprint — editorial 2-column spread with alternating cadence and caption margins. * Feature: True Continuous CSS Multi-Column Masonry — seamless vertical column masonry with fluid responsive breakpoints. * Feature: Cold-load thumbnail preloading and instant frame aspect-ratio reservation for zero layout shifts (CLS < 0.01). * Feature: Obsidian Studio UI refresh — refined high-contrast monochrome studio workspace with streamlined layout tabs and synchronized skins. * Asset: High-CTR WordPress.org Pure Symbol Icon Suite (256×256, 128×128, and scalable SVG) optimized for plugin directory and wp-admin search visibility. * Fix: Strict Pro feature isolation — ensure Spatial 3D tilt, holographic physics, client proofing, shoppable pricing dock, and advanced toolbar skins cleanly fall back to free standards when Pro is inactive. * Enhancement: Translation catalogue synchronization and optimized production bundle packaging. #### 1.0.1 * Fix: Admin sidebar menu icon sizing on the WordPress dashboard constrained to 20x20px with inline SVG data URI and global head style guard. * Feature: Curated Style Presets (Exhibition Hairline Frame, Architectural Curtain, Cinematic Pullback, Minimalist Drawer). * Enhancement: Layout rendering performance and zero-CLS image frame reservation. * Enhancement: Codebase hygiene, translation template updates, and package optimizations. #### 1.0.0 * Initial public release on WordPress.org. * Matcha Studio 3-panel dark workspace editor. * 6 Algorithmic layout blueprints: Grid, Masonry, Mosaic, Pinwheel, Bento, and Justified. * 1-Click Smart Fill aspect-ratio matcher. * Picture Framing & Matting system (5 realistic frame styles). * In-Frame Pan & Zoom cropping with 2D focal reticle. * Multi-Section Gallery Chapters (tabbed sub-stories in 1 gallery). * 1-Click 2x High-Res PNG Wall Snapshot & PDF Client Proofing Sheet export. * AI Vision metadata enrichment via Google Gemini (alt text, titles, captions, colors, focal points). * Frontend live search, color swatch filter, proofing tray, and accessible lightbox. * Native Gutenberg block and `[matcha_gallery]` shortcode. * Local vendored JS dependencies (zero CDN reliance). ## Meta * Version **1.0.3** * Last updated **5 days ago** * Active installations **Fewer than 10** * WordPress version ** 6.2 or higher ** * Tested up to **7.1.3** * PHP version ** 8.0 or higher ** * Language * [English (US)](https://wordpress.org/plugins/matcha-gallery/) * Tags * [gallery](https://lmo.wordpress.org/plugins/tags/gallery/)[lightbox](https://lmo.wordpress.org/plugins/tags/lightbox/) [masonry](https://lmo.wordpress.org/plugins/tags/masonry/)[photo gallery](https://lmo.wordpress.org/plugins/tags/photo-gallery/) [portfolio](https://lmo.wordpress.org/plugins/tags/portfolio/) * [Advanced View](https://lmo.wordpress.org/plugins/matcha-gallery/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/matcha-gallery/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/matcha-gallery/reviews/) ## Contributors * [ WPMatcha ](https://profiles.wordpress.org/wpmatcha/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/matcha-gallery/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://wpmatcha.com)