Title: Matcha Gallery – AI Photo Wall, Masonry & Portfolio Studio
Author: WPMatcha
Published: <strong>19.09.2026</strong>
Last modified: 30.09.2026

---

Пошук плагінаў

![](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

 Аўтар: [WPMatcha](https://profiles.wordpress.org/wpmatcha/)

[Спампаваць](https://downloads.wordpress.org/plugin/matcha-gallery.1.0.2.zip)

 * [Падрабязнасці](https://bel.wordpress.org/plugins/matcha-gallery/#description)
 * [Водгукі](https://bel.wordpress.org/plugins/matcha-gallery/#reviews)
 *  [Ўсталёўка](https://bel.wordpress.org/plugins/matcha-gallery/#installation)
 * [Распрацоўка](https://bel.wordpress.org/plugins/matcha-gallery/#developers)

 [Падтрымка](https://wordpress.org/support/plugin/matcha-gallery/)

## Апісанне

**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.
 * **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. * **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)

## Скрыншоты

[⌊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.

## Блокі

Гэты плагін прадастаўляе 1 блок.

 *   Matcha AI Smart Gallery AI-powered filterable image gallery with grid and masonry
   layouts.

## Ўсталёўка

 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.

## Часта задаваныя пытанні

### 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.

### 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.

## Водгукі

На гэты плагін няма водгукаў.

## Удзельнікі і распрацоўшчыкі

“Matcha Gallery – AI Photo Wall, Masonry & Portfolio Studio” з’яўляецца праграмным
забеспячэннем з адкрытым зыходным кодам. Наступныя людзі ўнеслі свой уклад у гэты
плагін.

Удзельнікі

 *   [ WPMatcha ](https://profiles.wordpress.org/wpmatcha/)

[Перакласці “Matcha Gallery – AI Photo Wall, Masonry & Portfolio Studio” на вашу мову.](https://translate.wordpress.org/projects/wp-plugins/matcha-gallery)

### Зацікаўлены ў распрацоўцы?

[Праглядзіце код](https://plugins.trac.wordpress.org/browser/matcha-gallery/), праверце
[SVN рэпазітарый](https://plugins.svn.wordpress.org/matcha-gallery/), або падпішыцеся
на [журнал распрацоўкі](https://plugins.trac.wordpress.org/log/matcha-gallery/) 
па [RSS](https://plugins.trac.wordpress.org/log/matcha-gallery/?limit=100&mode=stop_on_copy&format=rss).

## Журнал змяненняў

#### 1.0.2

 * 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).

## Мета

 *  Версія **1.0.2**
 *  Апошняе абнаўленне **2 дні таму**
 *  Актыўных установак **Менш за 10**
 *  Версія WordPress ** 6.2 або вышэй **
 *  Правераны да версіі **7.1.2**
 *  Версія PHP ** 8.0 або вышэй **
 *  Мова
 * [English (US)](https://wordpress.org/plugins/matcha-gallery/)
 * Тэгі
 * [gallery](https://bel.wordpress.org/plugins/tags/gallery/)[lightbox](https://bel.wordpress.org/plugins/tags/lightbox/)
   [masonry](https://bel.wordpress.org/plugins/tags/masonry/)[photo gallery](https://bel.wordpress.org/plugins/tags/photo-gallery/)
   [portfolio](https://bel.wordpress.org/plugins/tags/portfolio/)
 *  [Пашыраны прагляд](https://bel.wordpress.org/plugins/matcha-gallery/advanced/)

## Ацэнкі

Пакуль яшчэ няма водгукаў.

[Ваш водгук](https://wordpress.org/support/plugin/matcha-gallery/reviews/#new-post)

[Паглядзець усе водгукі](https://wordpress.org/support/plugin/matcha-gallery/reviews/)

## Удзельнікі

 *   [ WPMatcha ](https://profiles.wordpress.org/wpmatcha/)

## Падтрымка

Ёсць што сказаць? Патрэбна дапамога?

 [Перайсці да форуму падтрымкі](https://wordpress.org/support/plugin/matcha-gallery/)

## Падтрымаць

Ці жадаеце вы падтрымаць развіццё гэтага плагіна?

 [ Ахвяруйце на гэты плагін ](https://wpmatcha.com)