Visual Portfolio
  • Home
  • Features
    • Justified
    • Justified
    • Justified + Tilt Effect
    • Justified + Captions
    • Justified + Blend Mode
    • Slider
    • Slider
    • Slider Coverflow + Filterable
    • Slider + Thumbnails
    • Grid
    • Grid + Category Filter
    • Grid + Rows Vertical Centering
    • Grid + Gradient Overlay
    • Masonry
    • Masonry
    • Masonry + Infinity Scroll
    • Masonry + Image Filters
    • Masonry + Image Blur
    • Masonry + Caption Move
    • Tiles
    • Tiles + Popup Gallery
    • Tiles + Paged Pagination
    • Tiles + Custom Color
    • Tiles + Text Blend Mode
    • Posts
    • Posts Grid
    • Posts Quick View
    • Taxonomies
    • Theft Protection
    • Watermark Protection
    • Age Gate Protection
    • Password Protection
    • Right Click Protection
    • Advanced Features
    • Video Gallery
    • Album Gallery
    • Photos Proofing
    • Custom Hover Images (Animated GIF)
    • Video and Audio Popups
    • Filterable and Sortable
    • AJAX Search
    • Responsive Hover Overlays
  • Skins
    • Classic
    • Fade
    • Emerge
    • Fly
    • Caption Move
  • Social Feeds
    • Instagram
    • Youtube
    • Vimeo
    • Unsplash
    • X
    • Flickr
    • Google Photos
    • Dribbble
    • Twitch
    • RSS
  • Pricing
  • Resources
    • Docs
    • Contact
    • Request a Feature
    • Free vs Pro
    • Affiliates
    • Free Forums
  • Buy Visual Portfolio Pro
Buy Visual Portfolio Pro
  • 🚀 Introduction
    • Requirements
    • Installation
    • Quick Start
    • Purchasing Pro Plugin
    • Installing Pro Plugin
    • License and updates
    • Legacy licenses (before May 2025)
  • Compatibility
  • Portfolio
  • 📂 Portfolio Page
  • 🗂️ Projects
    • Project Settings
    • Project Formats
    • Taxonomies
    • Post Templates
    • Roles and capabilities
  • Blocks
  • 🖼️ Gallery Blocks
    • Content Source
      • Posts
      • Media
      • Taxonomies
      • Social
    • Skin
      • Skin settings reference
      • Classic
      • Fade
      • Fly
      • Emerge
      • Caption Move
    • Layout
      • Tiles
      • Masonry
      • Grid
      • Justified
      • Slider
      • Responsive behaviour
    • Layout Elements
      • Filter
      • Sort
      • Search
      • Pagination
    • Click Action
    • Albums
    • Video items
    • Protection
    • Custom CSS
  • Features
  • 🔌 Social Feeds
    • How social feeds work
    • Social Items and Profiles
    • CRON
    • Instagram
    • YouTube
    • Vimeo
    • Unsplash
    • X
    • Flickr
    • Dribbble
    • Twitch
    • VK
    • RSS
    • Social feeds troubleshooting
  • 📝 Proofing
  • 💾 Saved Layouts and Shortcodes
    • Shortcode reference
    • Elementor
    • WPBakery Page Builder
    • Classic Editor
  • ⚙️ Settings
    • General
    • Images
    • Popup & Lightbox
    • Watermarks
    • Social Feeds
    • White Label
    • Updates
    • Permalinks
  • Localization
  • Translation
  • Multilingual
  • Resources
  • ❓ FAQ
    • Why does filtering take time?
    • How do I change the style of single project pages?
    • How do I remove the overlay scrollbar?
    • What is the difference between Visual Portfolio and Visual Portfolio Pro?
    • Do I need the free plugin installed to use Pro?
    • Why was the free plugin deactivated when I activated Pro?
    • Can I try Visual Portfolio Pro before buying?
    • How many sites can I use my license on?
    • What happens when my license expires?
    • How do I renew an existing license key?
    • How do I cancel my subscription?
    • How can I get a refund?
    • How do I change the email on my order?
    • Where do I get support?
    • Does Visual Portfolio work with my theme or page builder?
    • Does it work on WordPress multisite?
    • Which external services does the plugin contact?
    • How do I add a gallery to a page?
    • How do I reuse the same gallery on several pages?
    • How do I make a gallery full width?
    • How many images can a gallery hold?
    • How do I reorder images in a Media gallery?
    • How do I change the order of projects?
    • How do I clone a project?
    • How do I change the number of columns on mobile?
    • Why does my 5-column grid show 4 columns?
    • Why are my images cropped, and how do I stop it?
    • Why are my images blurry?
    • Why is there a gap under my images in Masonry?
    • Why is the title not shown on top of the image?
    • Why do hover effects not work on my phone?
    • Why is only one category shown on each item?
    • How do I add a Read More button?
    • How are Views and Reading Time counted?
    • How do I change fonts, colors and spacing?
    • Can I show an animated GIF on hover?
    • How do I open items in a lightbox instead of the post page?
    • Can a gallery item link to an external URL?
    • Can I open a post or page inside the lightbox?
    • How do I link to a specific image in the lightbox?
    • Which video and audio services can I use?
    • Can the lightbox open my regular WordPress images and galleries?
    • Fancybox or PhotoSwipe?
    • Why does the filter not show my tags or custom taxonomy?
    • Why does the filter show only “All” or nothing?
    • Can visitors link to a filtered or paged view?
    • Where is Items Per Page?
    • Can I add a search box to the gallery?
    • Can I use the plugin without the Project post type?
    • How do I change the “portfolio” part of project URLs?
    • I deleted the Portfolio page. How do I get it back?
    • Who can edit projects and Saved Layouts?
    • Can videos play inside the gallery grid?
    • How do I make one item open several images?
    • Can I show a different image in the lightbox than in the grid?
    • Are the Media Library’s titles and captions used?
    • Does the plugin support WebP and AVIF?
    • How often are social feeds updated?
    • Can I edit imported social posts?
    • Why are likes not shown for social posts?
    • Can I show an Instagram hashtag feed or a Facebook page?
    • Where are social images stored?
    • Can several people select photos in the same proofing gallery?
    • Can the client download photos from a proofing gallery?
    • Does right-click protection stop image theft?
    • Are my original images changed by watermarks?
    • Does the plugin work with caching plugins?
    • How do I disable lazy loading?
    • Are galleries SEO-friendly?
    • Why does the editor preview not load?
    • How do I translate “Load More”, “All” and other gallery texts?
    • Does it work with WPML, Polylang, TranslatePress?
    • What is deleted when I uninstall the plugin?
    • Can I override the plugin’s templates?
  • 🐞 Troubleshooting
    • Site header displays above Popup gallery
    • Filter does not filter projects
    • 404 error on single portfolio pages
    • Images lazy loading conflict
    • Preview does not load in editor
    • Social feeds empty images
    • Social feeds do not loads
    • Download Failed: Unauthorized
    • An error occurred while updating Visual Portfolio Pro: Could not create directory
    • License activation errors
    • Migration to v3
    • Avada theme Portfolio post type conflict
    • Jetpack images lazy loading conflict with imagesloaded and masonry
    • Lightbox opens the post page instead of the image
    • Videos do not play in the lightbox
    • Load More loads nothing or repeats the same items
    • “Premium Only” notes on options I paid for
    • “To enable updates, please enter your license key”
    • Watermarks are not applied
    • Password or age gate is not shown
    • Proofing page returns 404
    • Users cannot access Projects
    • The block editor shows a JavaScript error or the sidebar is empty
    • Elementor lightbox opens on top of the plugin’s lightbox
    • WPML: the translated Portfolio page returns 404
  • 🧑‍💻 Developers
    • CSS Variables
    • WordPress Filters
      • Controls
    • WordPress Actions
    • jQuery Events
    • jQuery Methods
    • Changing default templates and styles
    • Disable enqueued plugins (JS, CSS)
    • Custom taxonomy for filter
    • REST API
    • Data reference
  • Home
  • /
  • Documentation

Troubleshooting

Fixes for the problems we are asked about most often. Each entry names the symptom, what causes it and what to do. If nothing here matches, open a ticket with your WordPress and plugin versions and a link to the page that misbehaves.

  • Site header displays above Popup gallery
  • Filter does not filter projects
  • 404 error on single portfolio pages
  • Images lazy loading conflict
  • Preview does not load in editor
  • Social feeds empty images
  • Social feeds do not loads
  • Download Failed: Unauthorized
  • An error occurred while updating Visual Portfolio Pro: Could not create directory
  • License activation errors
  • Migration to v3
  • Avada theme Portfolio post type conflict
  • Jetpack images lazy loading conflict with imagesloaded and masonry
  • Lightbox opens the post page instead of the image
  • Videos do not play in the lightbox
  • Load More loads nothing or repeats the same items
  • “Premium Only” notes on options I paid for
  • “To enable updates, please enter your license key”
  • Watermarks are not applied
  • Password or age gate is not shown
  • Proofing page returns 404
  • Users cannot access Projects
  • The block editor shows a JavaScript error or the sidebar is empty
  • Elementor lightbox opens on top of the plugin’s lightbox
  • WPML: the translated Portfolio page returns 404
Last modified September 6, 2026

Doc navigation

Previous Article FAQ Next Article Developers
Was this page helpful?
Yes No

How can we improve this documentation?

Visual Portfolio

Visual Portfolio

Let’s build stunning portfolio galleries with Visual Portfolio plugin for WordPress.

  • Home
  • WordPress Gallery Plugin
  • Pricing
  • Docs
  • Contact
  • Free vs Pro
  • Affiliates
  • Wordpress Themes
  • Lazy Blocks
  • Ghost Kit
  • AWB
  • X
  • Free Forums
  • Premium Support
  • Premium Account
  • Terms & Conditions
  • Privacy Policy

© 2026 Devoice LLC. All rights reserved.