Gallery by Visual Portfolio

By nK

★ 4.8/5 (341 ratings)50,000+ active installationsVersion 3.11.0

Build photo galleries, image galleries, and portfolio grids with gallery blocks. Masonry, lightbox, sliders, and filters included.

Description

Photo gallery and portfolio plugin for WordPress
★★★★★

Visual Portfolio is a WordPress gallery plugin built around gallery and portfolio blocks. Use it for photo galleries, image galleries, video galleries, and albums. Pick masonry, justified, tiles, grid, slider, or carousel layouts.

See Live Demo | Documentation | GitHub

Keep it simple with a basic image gallery, or go further with nested galleries, filterable portfolio grids, post grids, and taxonomy grids. Add images, choose a layout, then tweak skins and the lightbox. You do not need to write code.

🏆 Visual Gallery Builder

Build gallery and portfolio blocks without coding. Customize layouts visually with live preview in the editor.

Supported layouts: Masonry, Justified, Tiles, Grid, Slider, and Carousel. You get skins and the usual gallery controls in one place.

🚀 Optimized to be Fast as Native

Despite the rich functionality, the Visual Portfolio is optimized as much as possible, to be fast and lightweight.

Due to the modular code structure, all scripts and styles are loaded only when they are needed for the current page that displays your gallery. So, your pages will never load unused features.

Pictures are not loaded in the main thread due to lazy loading. Moreover, our plugin is compatible with third-party WebP providers and image optimization plugins.

Smart adaptive image sizes fully supported in any gallery, created with Visual Portfolio plugin.

📱 Layouts

Our gallery plugin shipped with popular layouts such as Masonry and Justified (Flickr). Every feature optimized and works seamlessly with all of these layouts, you just need to set up and go with no headache. See it in action:

🎨 Prebuilt Skins

Showcase your projects and gallery images with clean and beautiful skins. See it in action:

⚙️ Easy to Customize

The gallery block with live preview includes a lot of design settings that are point-and-click, no coding knowledge required. If you’re a bit more adventurous, the custom CSS module and PHP filters are set up to be easily used by developers.

📁 Portfolio Post Type

Optional custom post type portfolio will ensure all your portfolios to keep in a single post type. In this way, you can distinguish your portfolios from other post types. Taxonomies are used to categorize your portfolio types, it will help you to group and sort your portfolios. Moreover, you can use these portfolios as a source for your showcase gallery using Visual Portfolio block.

Customize and rename Portfolio archive templates using the gallery block and page builders: https://www.visualportfolio.com/docs/portfolio-archive/

In case you want to use Visual Portfolio plugin for photo gallery only you can disable custom post type registration.

💎 Posts Query Builder

Fine-tune the source of your galleries. Display posts, portfolios, taxonomies, and any other post types, filter by taxonomies, author, and date ranges, include or exclude specific posts, and build post grids or taxonomy grids from the same workflow.

🖼️ Photo Galleries

Create galleries from image sets right inside the gallery block: drop your images in and the gallery is ready. You can create unlimited image galleries with different styles, build album galleries with nested galleries in Pro, and combine images with video items for richer visual storytelling.

⚡ Powerful Lightbox

Visual Portfolio uses only modern solutions, and lightboxes are not an exception. High performance, mobile optimization, retina-ready, and a wide range of features available in Fancybox and PhotoSwipe plugins, that you can choose for your gallery lightboxes.

Mobile Optimized
Looks great on every device. Swipe to navigate, spread/pinch to zoom in/out supported on touch devices.

GPU Accelerated
Hardware accelerated animations for better performance and seamless user experience.

Smart Loading
Gallery images are responsive and loaded progressively using lazy loading on demand.

Social Sharing
You can allow users to share photos on Facebook, X, and Pinterest with social sharing buttons.

📹 Video and 🎵 Audio Support

Visual Portfolio plugin allows you to work with audios and videos within a single gallery. You can paste a supported video or audio URL and it will work automatically in the popup gallery. In Pro, you can also add dedicated video items directly to image galleries and post grids, including autoplay on open or playback on hover. The full list with supported vendors see below.

Supported Video Vendors:

  • Youtube
  • Vimeo
  • Instagram (Reels, video posts and IGTV links)
  • TikTok
  • Twitch
  • Facebook Video
  • DailyMotion
  • Wistia
  • VideoPress
  • TED
  • Rutube
  • Metacafe
  • Coub
  • Self Hosted Video

Supported Audio Vendors:

  • Spotify
  • SoundCloud
  • Mixcloud
  • Beatport
  • Self Hosted Audio

📈 SEO-Friendly

Visual Portfolio plugin is built keeping SEO and performance in mind by defining proper structure and tags. Furthermore, due to optimization, it is lightweight and fast when it comes to page load.

In addition our plugin add images in the sitemap for All In One SEO, Rank Math, and Yoast SEO plugins

🏳️ Multilingual & Translation Ready

Visual Portfolio adds a new layer of compatibility for WPML. All blocks are compatible with it and ready for translation. https://www.visualportfolio.com/docs/multilingual/

🛠 Built For Developers

Visual Portfolio gives you a wide range of filters and actions to customize every part of your gallery. Also, it allows you to overwrite templates and change it in the theme directory. Moreover, you can customize separate portfolio lists using custom CSS and CSS Variables.

🔥 Visual Portfolio Pro

The Visual Portfolio plugin is also available in a professional version which includes more features and enhanced performance! Learn more about Visual Portfolio Pro

In order to maintain the free version of the plugin on an ongoing basis, and to provide quick and effective support for free, we offer a Pro version of the plugin. The Pro version allows you to:

  • Video Items in Galleries and Post Grids
    Add video items directly into image galleries and post grids, with autoplay on open or play on hover.

  • Gallery Format and Albums
    Display nested galleries and album-style content in image galleries, posts, and taxonomy grids.

  • Taxonomies as Gallery Source
    Build galleries directly from taxonomy terms, not only from posts or images.

  • Advanced Skin Settings

    • Image Filters and Blend Mode – apply Instagram-like filters on images for Normal and Hover states
    • Transformations – control the image transformation and border radius for Normal and Hover states
    • Typography – control every text part of gallery captions and overlays
    • Dimensions – controls paddings, margins and border radius of captions and overlays
  • Stylish Interaction Effects

  • Social Feeds
    Automatically fetch posts from your social networks to display in gallery on your site.

  • Theft Protection

    • Watermarks – add your logo or text on top of your images, once or tiled across them, to make them harder to steal
    • Password Form – add a password to gallery blocks and send it to your clients
    • Age Gate – Protect visitors from viewing adult content
  • Photos Proofing
    Communicate with your clients in a modern way:

    1. Create Proofing Gallery – Easily create a gallery with photos, as you did before. Change styling, layout, etc. if you want.
    2. Send to Clients – Share one gallery with one client or a hundred. Each client gets a personal link, their own selection and private notes on photos.
    3. Get Approval – Once a client sends their selection, you will be able to compare the picks of all clients and copy filenames for Lightroom or Capture One.
  • Advanced Click Actions
    Manually configure how to open specific item types and filter clicking on title or on image.

  • Responsive Breakpoints Settings
    Manually control the screen sizes, which used by the automatic responsive function to adapt your gallery layouts.

  • AJAX Improvements
    Requests properly cached and links preloaded before you click.

  • Advanced Query Settings
    Filter by Author, Date Range, Ignore Sticky Posts, exclude posts without Featured Image, and much more…

  • Albums, Gallery Format, and Taxonomy Grids
    Build nested gallery structures, output gallery format content, and create visual taxonomy grids from the same workflow. See the Taxonomies demo.

  • Quick View for Posts and Pages
    Display posts and pages in popup iframe, not only image and video galleries. It’s like works preview in Dribbble and Behance, but on your own site.

  • Popup Gallery Deep Linking
    Makes URL automatically change when you open popup and you can easily link to a specific popup image.

  • White Label
    Possibility to use your brand name and logo instead of our “Visual Portfolio”.

Find much more portfolio and gallery features of Visual Portfolio Pro today!

🌟 More Features

  • Lightboxes for Standard WordPress Images
    Image lightbox available for Visual Portfolio galleries as well as for standard WordPress images and galleries in your content.

  • AJAX Loading and Pagination
    Every dynamic part of the Visual Portfolio plugin is using AJAX to update the gallery content in live mode.
    Organized galleries and portfolio lists will make your website look more professional, easy to navigate and result in a better user experience. We prepared 3 types of paginations for you:

    • Infinite Scroll
    • Load More button
    • Paged pagination
  • Filter
    Filter your gallery and portfolio by taxonomies (mostly categories and tags). Let users select a category and see the relevant items.

  • Sort gallery items by date and title
    Users may sort gallery items by date and title.

  • GIFs Support
    Our plugin automatically displays the animated GIFs in photo galleries. Also, you can show the animated GIFs on mouseover with the Pro plugin.

  • Items Gutters
    Manually adjust the spacing between gallery images and projects.

  • Images Lazy Loading
    Images lazy loading boost your page loading speed. You don’t need to worry about it, just use your beautiful images in the gallery, Visual Portfolio will do all the work for you.

  • Images Aspect Ratio
    All built-in gallery layouts support custom image aspect ratio. You don’t need to crop the image manually.

  • Images Focal Point
    Sometimes it is very important to specify the focal point so that the custom aspect ratio does not cut off important parts of the photos. For example, people’s faces on the portrait photos.

  • Custom Links for Gallery Images
    By default, gallery images will contain the links to original images. You can manually set the custom links, for example, to a website or Youtube video.

  • RTL Support
    Visual Portfolio natively supports RTL languages, proper styles loaded automatically, without user interaction.

  • Elementor and WPBakery Page Builder support
    There is a helpful widget for Elementor and shortcode for WPBakery Page Builder, which will let you select one of the available Saved Layouts and output it.

  • Responsive and Mobile Ready
    Visual Portfolio and Galleries are completely responsive and mobile ready – layouts automagically transforms to display perfectly on your screen size.

  • Custom CSS
    Deeply customize the look of your gallery using custom CSS and CSS Variables.

  • … And Much More
    All available features you can find on the plugin’s site and documentation.

Installation

Automatic installation

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t need to leave your web browser. To do an automatic install of Visual Portfolio, log in to your WordPress dashboard, navigate to the Plugins menu and click Add New.

In the search field type “Visual Portfolio” and click Search Plugins. Once you’ve found our plugin you can view details about it such as the point release, rating and description. Most importantly of course, you can install it by simply clicking “Install Now”.

Manual installation

The manual installation method involves downloading our Visual Portfolio plugin and uploading it to your webserver via your favourite FTP application. The WordPress codex contains instructions on how to do this here.

FAQ

Does Visual Portfolio has documentation?

Yes, our plugin has documentation to easily get started with galleries. Read it here – Visual Portfolio Documentation

What themes does Visual Portfolio support?

Visual Portfolio has been tested with many WordPress themes and supports all major WordPress themes. Since we follow WordPress’ plugin development guidelines, you can rest assured that Visual Portfolio galleries will work perfectly, no matter what theme you use. If you’ve installed Visual Portfolio and are facing issues, it might not be because of a theme incompatibility. Please get in touch with the support team by opening a support ticket in our support forum, and we will fix it for you.

Do I have to remove other Gallery and Portfolio plugins if I install Visual Portfolio?

That is recommended. Visual Portfolio is designed to be an all in one Gallery and Portfolio plugin. If you use other Gallery plugins with Visual Portfolio on your website, not only will the performance of your website be negatively affected, but both plugins working together can produce unexpected conflicts or errors.

Are the galleries mobile friendly?

Yes, Visual Portfolio built with mobile optimization in mind. It will automatically fit your screen size, so you don’t need to worry about. Furthermore, we prepared lazy loading, which significantly increases page loading speed. Before making a decision, just check by yourself how Visual Portfolio works on mobile devices.

Can I upload multiple images at once?

Yes, you can batch upload entire photo galleries at one time thanks to WordPress media library functionality.

Is there pagination for photo galleries?

Yes, you can use 3 type of pagination when displaying photo galleries or posts. Choose the number of photos to display and select Paged, Load More or Infinite Loading pagination. Examples with all gallery pagination types are available on the Visual Portfolio website.

Can I filter images and projects by categories?

Yes, our plugin has built in support for AJAX Filter by items categories. See a couple of examples:

Can I add an external links to galleries?

Yes, you can add external links to your gallery items.

Is Visual Portfolio developers friendly?

Yes, we prepared a lot of filters and actions for developers, so you can easily extend default functionality for your need. Read here more info for developers.

Is Visual Portfolio translation ready?

Yes, Visual Portfolio has full translation and localization support via the visual-portfolio textdomain. To submit a translation, see https://translate.wordpress.org/projects/wp-plugins/visual-portfolio/

More Information

For more information, feel free to visit Visual Portfolio official website.

Screenshots

Changelog

3.11.0 – Nov 17, 2026

  • improved the experimental Gallery Loop blocks:
    • added Saved Layouts built from Gallery Loop blocks. A gallery syncs with one from its block menu, takes the layout’s item design and lightbox, and keeps its own images or posts. A setting changed on the page is marked and can be reset to the layout, and a locked layout allows no changes
    • added the Saved Layouts library, with live previews, the pages each layout is used on, filters, duplicate, copy shortcode, export and import. A layout deleted for good leaves the galleries synced with it looking as they did
    • added Gallery Loop to the block switcher of the Visual Portfolio and Saved Layout blocks, which converts a legacy gallery with its source, layout, skin, filter, sort, search and pagination
    • added folder and ZIP import to image galleries. Files upload three at a time in the order of their names, and files the gallery already holds are skipped
    • added Move left, Move right and Remove from gallery to the toolbar of an image in the preview
    • added Label and Order settings to the Gallery Filter, and the List tab in the sidebar for the items of a filter shown as a dropdown
    • added a choice of formats to the format badge of Item Image
    • added Sticky posts to a post types set that includes posts
    • added a tablet and phone block gap, and cover padding, set with the editor’s responsive styles
    • changed the tablet and phone columns to switch at the theme’s breakpoints, the ones the editor previews, instead of 768px and 576px
    • changed the blocks inside an item to be spaced by the theme’s block gap, so a caption no longer sits flush against the picture
    • changed the selects, text and date fields of the filter, sort and search blocks to one look in the theme’s type and colors
    • changed Justified and Masonry layouts to hold their rows and columns before the page scripts run
    • removed the size settings of Item Image and Item Cover from the Justified layout, where they did not change the picture. They come back with their values when the layout changes
    • fixed an Item Cover minimum height making a picture taller than its row in the Justified layout
    • fixed masonry items overlapping in the editor until the window was resized
  • added abilities that let AI agents list, create and change Gallery Loop galleries through the WordPress Abilities API and the MCP Adapter, on WordPress 7.1 and newer
  • added a Live Preview to the plugin page on WordPress.org
  • changed the Settings, Saved Layouts and Proofing pages, and the Projects, Categories and Tags lists, to one page header with sections as tabs, on a white background
  • changed the Settings to show each setting on its own row, with its name and description beside the control
  • fixed galleries not laying out again when their container width changed without a window resize
  • fixed galleries laying out again and again when they made the page scrollbar appear and disappear
  • fixed the lightbox opening a scaled-down copy of a tall image that fits its largest size, such as a long screenshot
  • fixed the plugin name missing from the Lazy Loading setting
  • Pro:
  • added advanced filters to the Gallery Loop:
    • the Gallery Filter lists any taxonomy or chosen image categories, takes several terms at once and shows child terms
    • added the Gallery Author Filter, Gallery Date Filter and Gallery Field Filter blocks
    • added the Gallery Active Filters block, which shows each choice with a way to remove it and clears them all
    • added the Gallery Filters Panel block, which puts the filters behind a button that opens a drawer, on phones or always
    • every filter works as links or a form, without JavaScript too
  • added Import from server, which adds the files uploaded over FTP to the vp-import folder in uploads to a gallery, with the same order, duplicate skips and progress as a folder import
  • added watermarks to Item Cover pictures, so galleries converted from the Fade, Fly, Emerge and Caption Move skins are watermarked too
  • added the posts count of a term to Item Meta in a Taxonomies gallery
  • added the editor’s Tablet and Mobile screens to Move under image on Item Cover
  • added the Taxonomies and Social sources and Photo Proofing selections to the abilities for AI agents
  • added Pro settings to the conversion of a legacy gallery: sources, post filters, protection, image effects, Caption Move, typography, infinite scroll, search, quick view, album counts and proofing
  • added Changed markers, and reset to the layout, to Pro settings on galleries synced with a Saved Layout
  • changed the Social Feeds and Proofing lists to the plugin’s page header
  • fixed the Social Feeds and Proofing screens disappearing for administrators and editors when the Portfolio post type was turned off
  • removed unused libraries that some hosting scanners flagged as malicious, which makes the plugin 12 MB smaller

3.10.1 – Nov 10, 2026

  • changed the WordPress.org changelog to show recent releases with a link to the full history
  • Pro:
  • fixed a critical error that could stop the plugin from loading when other plugins are active
  • fixed text watermark previews having different dimensions from saved copies in some browsers
  • fixed galleries added after page load not preloading their next page

3.10.0 – Nov 9, 2026

  • improved the experimental Gallery Loop blocks:
    • changed the start of a new gallery: add its images first, by upload, Media Library or a drop, then pick a layout from previews drawn with those images. Posts, Taxonomies and Social sit in an “Other sources” menu
    • changed a new image gallery to show all its images on one page and open a picture larger
    • changed “Change layout” in the toolbar to show on every loop with blocks. Picking a layout replaces the blocks, and undo works
    • fixed a picked layout being locked behind “Edit pattern”
    • fixed Item Cover leaving a gap on tall tiles
    • fixed Query Total and the Carousel Indicator counter showing sample numbers in the editor
    • fixed layout previews showing the No Results text, and nearly empty thumbnails in the inserter
    • fixed Carousel Thumbnails ignoring a centered row on the page
    • fixed an empty carousel showing its controls on the page
    • fixed Infinite Scroll reloading without end and never adding a page, and a Load More beside it adding items already shown
  • changed the General, Images and Popup & Lightbox settings to WordPress controls, with rarely changed settings in collapsed groups
  • fixed Load More doing nothing after one failed request until the page was reloaded
  • fixed the Fade, Fly and Emerge item styles taking two taps to open an item on iPhone and iPad
  • fixed a custom portfolio base replaced with the site’s post name structure, which returned 404 on ordinary pages. The first request after the update corrects a saved base
  • Pro:
  • added a separate selection for each client to Photo Proofing:
    • one gallery gives every client a personal link, their own selection, private notes on photos and a status
    • new galleries start in this mode, and existing galleries keep one shared selection
    • clients register with a name on the shared link, or you add them and send invitations
    • a review window shows clients by status, one client’s picks, notes and history, and the votes of all who sent
    • comments are hidden on these galleries, and notes replace them
  • added filename copying for Lightroom, Capture One or one per line, and a CSV download, to Photo Proofing
  • added an email for each submission or a daily digest, a copy for the client, and reminders that are each sent once, to Photo Proofing
  • added an expiry date to proofing galleries
  • changed the default of Copy Filenames on shared proofing galleries to the Lightroom format
  • changed a new proofing gallery to ask for photos first, and for the selection mode before publishing
  • removed the Activity tab from proofing galleries. Each client shows the moments that matter in one line
  • fixed Copy Filenames copying only part of a selection when clicked before every photo had loaded
  • fixed saving a proofing gallery from an editor opened earlier bringing back the client’s previous selection and status
  • improved Watermarks:
    • added the Text source, for a watermark made of your own text in the color you pick
    • added the Tiled layout, which repeats the watermark over the whole image with an angle and gaps
    • added a preview on photos from your Media Library that follows every change before you save
    • added the progress of watermark generation to Settings, with Pause and Resume, and the status of each image to the Media Library and the gallery editor
    • fixed watermarks not being generated in the background, including on hosts that block requests a site makes to itself
    • fixed galleries showing incomplete watermarked copies while images were regenerated or after a failed run
    • fixed the Opacity setting being ignored for a JPEG logo
    • fixed watermarked copies saved in the wrong format on sites where WordPress converts image sizes to WebP
    • fixed Remove Watermark in the Media Library reporting success while the copies stayed, and the Media Library buttons staying stuck after an error
  • added the sync status of each social feed, with its item count and last sync, to the gallery editor and to the account cards in Settings
  • changed the White Label, Updates and Social Feeds settings to WordPress controls, matching the free settings
  • fixed Sync Now reporting success when a feed failed
  • fixed social feeds syncing every 4 hours instead of every 2
  • fixed Reconnect on Instagram filling a different account, and added Reconnect to Unsplash and Dribbble
  • fixed classic Social galleries showing no items in the block editor
  • fixed a deep link to a lightbox slide on a later page of a classic gallery opening the first slide or nothing
  • fixed pagination refusing every later page after one page failed to preload, and a login or error page loading in place of gallery items
  • fixed the Pause every setting of Infinite Scroll in the Gallery Loop counting pages loaded by a Load More beside it
  • fixed the license link on the Updates page and other Pro settings links on sites with the Portfolio post type turned off
  • fixed tilt, image effects and other Pro hover effects taking two taps to open an item on iPhone and iPad

3.9.0 – Oct 24, 2026

  • added WordPress 7.2 compatibility
  • raised the minimum PHP requirement to 8.3
  • improved the experimental Gallery Loop blocks:
    • added Carousel Navigation, Previous, Next, Indicator, Autoplay and Thumbnails blocks, placed anywhere inside the loop
    • added Query Total and End of List blocks, and a Gallery Search block whose search comes with Pro
    • added the Fade carousel effect, and carousel effects in browsers without scroll-driven animations
    • added a pattern editor for the Tiles layout, with the old patterns kept as presets
    • added Sticky posts, Authors, Formats and excluded terms to the Posts source
    • added images by URL from outside the Media Library, and Crop and Replace in the image toolbar, to the Media source
    • added the filter as a dropdown, the sort as links, row gaps, grid alignment, and tablet and phone column counts
    • added the lightbox chosen in Settings, with its caption sources
    • added transforms from the Gallery, Latest Posts and Query Loop blocks
    • changed the blocks to print nothing below WordPress 7.1
    • security fix: a custom query saved by a contributor could show other authors’ drafts
  • improved block editor loading: the Custom CSS code editor loads only when it is opened, so the editor starts with about half the JavaScript
  • changed the image picking buttons and the chosen image card to the WordPress 7.2 featured image style
  • security fix: logged-in users without the needed role could search draft and private post titles, open the gallery preview, or run admin-only plugin requests
  • security fix: custom CSS could close the tag it is printed in
  • fixed custom CSS losing & nesting, > selectors, rules wrapped in <style> tags and rules written after a closing style tag
  • fixed styles and carousels on right-to-left sites
  • fixed the Media Settings panel showing empty thumbnails for galleries saved with image IDs only
  • fixed the focal point control overlapping the image
  • fixed the block editor preview breaking on galleries with a few hundred images
  • fixed the welcome screen being skipped right after activation
  • Pro:
  • improved the experimental Gallery Loop blocks:
    • added albums, image effects, tilt, caption move, hover media, video thumbnails, deep links, right-click protection, watermarks and Quick View
    • added a marquee mode to the carousel autoplay
    • added the Cover, Reveal, Warp, Drop and Stack carousel effects, with more transitions and rows
    • added a tiles pattern of its own for tablets and phones
    • added mixed social feeds
    • fixed every page of a social or taxonomy loop showing the first page
  • added a feed source picked in each social gallery, so one connection serves several galleries
  • changed “Sync All Accounts” to “Sync Now”, which syncs the feeds galleries show
  • added a link on the Updates page to where the license key is
  • security fix: users without the needed role could activate the license, change watermark settings, list Facebook pages, search users by email, read album images of non-public content, rewrite an approved proofing selection, or use proofing on a password-protected gallery without its password
  • fixed a deep link to a lightbox slide added by Load More opening nothing
  • fixed a local video without a cover image showing as an empty item with a PHP warning
  • fixed browsers keeping old Pro styles after an update
  • fixed Facebook watch links, Instagram links without a trailing slash or with _ or - in their ID, and Twitch videos on sites with a port in the address not opening in the popup

3.8.2 – Sep 10, 2026

  • fixed images with empty alt text being written with a valueless attribute, which SEO crawlers counted as missing alt text
  • Pro:
  • fixed Click Action set to Disabled still linking gallery items that carry an audio or a local video URL
  • fixed one failed plugin update leaving the rest of the queue stalled until the page was reloaded

3.8.1 – Aug 31, 2026

  • changed Visual Portfolio to stay active next to Visual Portfolio Pro instead of being deactivated
  • fixed Pro gallery templates and styles being ignored on networks where Visual Portfolio and Visual Portfolio Pro are activated at different scopes

3.8.0 – Aug 26, 2026

  • added Gallery Item blocks for building the item template inside the experimental Gallery Loop: Image, Title, Description, Date, Author, Categories, Read More, Cover and Meta
  • added WordPress 7.1 compatibility
  • improved gallery loading speed on portfolios with many images
  • fixed Load More fetching the next page and adding nothing, on sites whose markup contains <body inside inline CSS or JavaScript
  • fixed the block editor preview jumping while it resized
  • fixed the Elementor widget preview rendering without its styles
  • raised the minimum PHP requirement to 7.4
  • Pro:
  • added Gallery Loop support to every Pro source, so social streams, protected galleries and Pro layouts work inside the new blocks
  • fixed YouTube video backgrounds asking some visitors to sign in before playing

3.7.1 – Jul 21, 2026

  • fixed Fancybox afterShow callback arguments so popup listeners receive the gallery instance correctly
  • Pro:
  • fixed Load Next Pages not running in Fancybox lightbox
  • fixed popup freeze when deep linking to slides loaded via Load Next Pages
  • fixed N+ images counter flashing when navigating Fancybox slides
  • fixed stale same-version Pro update notice after upgrade

3.7.0 – Jul 21, 2026

  • added Item Excerpt as a popup title/description source
  • added admin dashboard widgets — Portfolio Activity widget and portfolio count in At a Glance
  • fixed editor preview under Cloudflare Rocket Loader (inline VPData marked as cfasync-safe)
  • fixed block editor script loading when mod_substitute line limits truncated large scripts
  • fixed asset enqueue errors when layout or items click action options are missing
  • Pro:
  • added Load Next Pages for popup galleries — automatically load the next page while browsing lightbox when Load More or Infinite pagination is used
  • improved social video reliability — cache social videos locally and refresh expired Instagram CDN URLs
  • fixed Item Excerpt popup caption source for album images

3.6.2 – Jun 9, 2026

  • added custom alt text support for gallery items — override alt text per image in the editor
  • updated popup share buttons: Twitter renamed to X, added LinkedIn
  • show Saved Layouts shortcuts in the frontend admin bar for Portfolio Manager and other roles with Saved Layouts access
  • fixed welcome screen redirect when Portfolio CPT is disabled
  • fixed portfolio roles not being removed during plugin cleanup
  • Pro:
  • added configurable proofing labels (id/filename/title/description)
  • improved Instagram business profile sync and cache profile avatars locally
  • improved self-hosted video support for MOV and other formats
  • use video featured image as gallery cover when no custom cover is set
  • fixed video thumbnails disappearing after AJAX pagination
  • fixed popup share buttons when deep linking is enabled

3.6.1 – May 5, 2026

  • compatibility fixes for WordPress 6.9 and 7.0; tested up to 7.0
  • improved drag-and-drop reordering in the editor (modernized implementation)
  • refined editor and settings controls (fields aligned with WordPress components)
  • fixed fatal error in the block editor when word count ran alongside certain content pagination plugins
  • minor fixes and improvements
  • Pro:
  • improved PHP 8.4 compatibility
  • fixed proofing gallery selection not persisting reliably
  • fixed proofing status not updating correctly after the editor autosaves post meta

3.6.0 – Mar 23, 2026

  • refined image settings in popup in image galleries – better fields and overall ux
  • refined welcome screen
  • improved featured image focal point on posts – setting hidden by default in collapse
  • improve settings page: disable the Save Changes button when no changes are made
  • fixed missing aria-label on overlay/item links with empty <a> tags
  • fixed slider gap on RTL sites
  • minor fixes and improvements
  • Pro:
  • added support for video items in image gallery and in post grids. Autoplay video on gallery item automatically or on hover https://www.visualportfolio.com/video-gallery/
  • added Gallery format and albums (nested gallery) support for image galleries, posts and taxonomy grids https://www.visualportfolio.com/album-gallery/
  • added support for displaying Taxonomies as gallery content source https://www.visualportfolio.com/taxonomies/
  • improved social feeds fetching queue startup condition: start immediately when a new social integration is added
  • fixed broken preview images in setup wizard skin examples
  • fixed proofing gallery permalink 404 by deferred rewrite self-healing
  • fixed the social feeds start queue trigger. Feeds now begin fetching as soon as the integration is added, and no longer depend on the block being added to the page
  • fixed search feature does not work correctly with paginated pages
  • fixed Social Items and Social Profiles menu items from displaying when no integrations are enabled

3.5.2 – Feb 18, 2026

  • security: fixed local file inclusion via path traversal

3.5.1 – Feb 12, 2026

  • updated supported WP version to 6.9
  • added support for Blocksy settings in our Portfolio CPT
  • minor changes

3.5.0 – Feb 6, 2026

  • improved performance by reducing database queries
  • minor changes
  • Pro:
  • !IMPORTANT: Google Photos integration completely removed
  • !IMPORTANT: social integration migrated to custom post type. The system will automatically migrate your old social posts to the new system. This will take time because migration occurs in small portions.
  • added ability to manage downloaded social posts in custom post type and images in Media library
  • improved proofing feature:
    • added possibility to reset proofing status
    • added possibility to save selection before submitting
    • added filter by selected/unselected
    • added possibility to require minimum and maximum number of images for submission
    • improve proofing actions bar – added number of selected and total number of images, added Save button, changed select/deselect links to checkbox
  • improved performance in image galleries by removing redundant full option calls

3.4.1 – Nov 11, 2025

  • fixed sticky posts appearing in Manual Selection posts source
  • Pro:
  • fixed option Ignore Sticky Posts incorrectly change output for Current Query and Custom Query posts sources
  • fixed option Ignore Sticky Posts appear when Manual Selection posts source selected

3.4.0 – Nov 5, 2025

  • added custom lightbox gallery support using .vp-lightbox-gallery class
  • added lightbox event support for third-party galleries. For example, JS events like initFancybox and beforeInitPhotoSwipe now also fire on non-portfolio galleries
  • added SEO optimizations
  • fixed register_script to use in_footer true by default, which we changed in recent plugin updates and broke some features, for example – iframe preview resizer
  • fixed lazy loading conflict with WordPress Lightbox block
  • fixed pattern context bug and posts query type handling (fixed issue with displaying block when WooCommerce installed)
  • fixed RSS feed generation for portfolio archives
  • fixed controls persistence and rendering in Saved Layouts
  • fixed taxonomy filter counts to use actual query results
  • fixed experimental filter block to work with nested loop blocks
  • skip lazy loading from applying to images with fetchpriority=”high” attribute
  • Pro:
  • migrated VK to new api domain
  • deprecated Google Photos integration
  • fixed click action for custom image
  • fixed updater api

3.3.16 – Jun 26, 2025

  • started our way to transition to modern blocks. Added new experimental blocks:
    • DON’T USE THESE BLOCKS ON PRODUCTION! Development is still in progress and we may break these blocks.
    • Gallery Loop
    • Filter by Category
    • Pagination Wrapper
    • Infinite
    • Load More
    • Next
    • Previous
    • Numbers
    • Sort
  • Pro:
  • fixed proofing gallery hash links in comments
  • minor fixes

3.3.15 – Jun 4, 2025

  • fixed broken css and js urls for lazyload fallback (used in legacy browsers only)
  • Pro:
  • updated used X API to v2
  • fixed Google Photos integration API errors
  • fixed X integration caching issue
  • fixed social integration download image resolution conversion during compression
  • fixed click action for item with custom popup image
  • fixed updater caching issue that sometimes caused Forbidden errors

3.3.14 – May 25, 2025

  • tested with WordPress 6.8
  • fixed WPML error in Saved Layouts
  • changed links from visualportfolio.co to www.visualportfolio.com
  • rename Twitter to X
  • Pro:
  • migrate Pro plugin from Paddle to LemonSqueezy
    • added support for affiliate links
  • fixed _load_textdomain_just_in_time notice

3.3.13 – Mar 25, 2025

  • fixed broken Swiper when installed Elementor 3.28
  • fixed rare bug with displaying category links on archive pages
  • Pro:
  • added support for more Audio formats in popup Audio links (https://www.visualportfolio.com/docs/projects/project-formats/#supported-audio-platforms)
  • added support for more Video formats in popup Video links (https://www.visualportfolio.com/docs/projects/project-formats/#supported-video-platforms)
  • fixed wrong infinity scroll loading when permalinks set to Plain
  • fixed GIF hover image reset when hovering on inner overlay elements

3.3.12 – Dec 20, 2024

  • fixed order by Image Title when both Title Source and Description Source is set to None
  • fixed Portfolio Manager role editing Saved Layouts when Project custom post type disabled
  • fixed image selection popup in block editor JS error

3.3.11 – Dec 15, 2024

  • added WP 6.7 compatibility
  • fixed id attribute rendering
  • fixed some styles in editor
  • Pro:
  • fixed Advanced Click Actions sometimes not properly displaying a Popup
  • fixed title display error in popup caption
  • fixed Instagram integration – you must reconnect to use the Instagram API instead of deprecated Instagram Basic Display API. Learn more: https://www.visualportfolio.com/docs/social-feeds/instagram/

3.3.10 – Sep 30, 2024

  • fixed possible XSS via stored HTML and Fancybox script

3.3.9 – Jul 17, 2024

  • fixed Sort by Date option not working correctly
  • fixed PHP warning when image was removed from Media library but still exists in the gallery
  • fixed WPRocket delay JS conflict with lazyloading

3.3.8 – May 29, 2024

  • Pro:
  • fixed click action on gallery items with a custom URL in saved layouts

3.3.7 – May 27, 2024

  • fixed displaying date on gallery items
  • fixed gallery images resets data in saved layouts

3.3.6 – May 16, 2024

  • fixed DESC order for “Manual” and “Rand” image orders
  • rename “Default” order to “Manual”
  • Pro:
  • fixed Hover CSS Filter styles loading if there is no Default CSS Filter provided
  • fixed custom image URL in the gallery, applied from the first item to all other items

3.3.5 – May 15, 2024

  • fixed PHP warning from array_key_exists function
  • fixed wrong attribute output for select control with bool value
  • fixed gallery sorting algorithm, now it should work correctly

3.3.4 – May 11, 2024

  • fixed dynamic selector block options rendering on the frontend.

3.3.3 – May 11, 2024

  • fixed custom title tag XSS vulnerability (properly escape the custom tag and prevent using non-predefined values)

3.3.2 – Apr 30, 2024

  • add more sort options in image galleries: Item Title, Item Description, Image Title, Image Description, Image Caption, Image Alt
  • improved image gallery sort code – images with empty field will be always placed after items with non-empty field
  • fixed the behavior of the “All” filters link when the portfolio archive page set as the home page
  • Pro:
  • fixed Skin typography settings error in WP 6.5
  • fixed image gallery non-working Hover and Custom Popup settings when you change it
  • fixed horizontal thumbnails displaying in Fancybox
  • fixed displaying Pro plugin settings opacity

3.3.1 – Mar 13, 2024

  • added support for Download button in PhotoSwipe
  • added Horizontal Order option to Masonry layout
  • added support for lazy loading inside AJAX callbacks
  • added support for WooCommerce images lazy loading
  • improved block gallery images in editor – allow selecting images with shift key pressed
  • changed Justified Row Height option minimum threshold to 20
  • fixed gallery images in block editor Uncategorized filter
  • fixed image blinking after filter in Masonry, Tiles and Grid layouts
  • removed stagger delay from Masonry, Tiles and Grid layouts because it is not working properly in large galleries
  • minor improvements
  • Pro:
  • fixed Overlay Under Image option in Emerge and Caption Move styles

3.2.4 – Feb 26, 2024

  • added stagger delay for Masonry, Grid and Tiles layouts
  • added proper horizontal order for Masonry layout
  • added possibility to edit gallery images in bulk
  • added gallery images filter by category in editor
  • fixed Portfolio menu item name change when on Taxonomy archive page
  • fixed duplicating Portfolio page after WordPress XML file import
  • Pro:
  • added Twitch avatar caching to fix missing link
  • added possibility to add any block on Proofing pages
  • fixed Grid vertical align option
  • minor fixes

3.2.3 – Dec 12, 2023

  • fixed displaying editor block when creating new Saved Layout

3.2.2 – Nov 29, 2023

  • added support for asset file change time when enqueue without .asset.php – better support for caching plugins
  • fixed Elementor preview stopped working

3.2.1 – Nov 29, 2023

  • fixed Pro plugin path and url detection – now it should work correctly when Free plugin is removed
  • fixed sitemap fatal error

Further changelog entries can be found in the CHANGELOG.md file.