Image and video gallery from Google Drive is a plugin for WordPress that connects your site to your Google Drive. With this plugin, you can select any folder in your Drive or a Shared drive and the plugin will convert it into a gallery, displaying any photos or videos in a page or a post on your website. Any folders and their subfolders will also be displayed in the gallery as nested galleries.
All the data is sourced from Google Drive with nothing but the plugin configuration being a part of your website. This enables your site to load faster as the images are loaded from Google and not from your hosting provider. It may also save you costs for your site hosting, as the big files of the gallery are not stored as part of your site. On top of that, if you ever decide to move or reinstall your site, simply install this plugin again on the new site and your old galleries will still be there and working.
Having the photos in Google Drive also gives you a familiar and easy-to-navigate UI for gallery management. You can give individual people or groups granular permissions to the Drive folder, making them able to add photos to a particular gallery without giving them full access to your site. They will then be able to manage the content of the gallery through Google Drive, without having to learn how to work with WordPress. You can also manage all content in your organization with Shared drives owned by your organization’s Google Workspace (formerly known as G Suite).
Using this plugin is very straightforward. Once the plugin is installed and configured, you can add a Google Drive gallery to any page or post. If you are using WordPress 5 or newer with the block editor (i. e. Gutenberg), there is a block that you can add that will allow you to choose a folder with a graphical user interface. It also makes it possible to configure each individual gallery very easily, should you want to do that. If you are using an older WordPress version or are still using the classic editor, there is a shortcode you can use instead of the block.
- Display any Google Drive folder as a gallery
- Subfolders are automatically displayed as nested galleries – no need to configure them
- You can restrict the plugin to a certain folder (we call it the “root” folder), making sure that no data outside this root folder will ever be displayed on your site
- Insert a gallery with a shortcode or with a click of a button
- Provides a Gutenberg block, making sure that your galleries will work even in WordPress 5
- Also works with Shared drives (formerly known as Team drives)
- Supports videos as well
- WordPress 4.9.6 or higher
- PHP 5.6 or higher
All the sources for the plugin and the build process are detailed in our Github repo.
This plugin provides 1 block.
- Image and video gallery from Google Drive
- Download and install the plugin from the WordPress plugin directory or from GitHub
- Create a Google app and configure the plugin
- Select a root directory for the plugin to use
- Add a gallery
How to configure this plugin?
See our documentation.
How do I create a Google app?
We have a special page in our documentation just about that.
What are the other options for this plugin?
For more info about all the options see the documentation page about advanced options.
How do I create a shortcode?
To show a Google Drive gallery add the shortcode
[sgdg path="Folder name"]to the page where “Folder name” is a folder in the root directory of the plugin.
It is also possible to use subdirectories with the shortcode
[sgdg path="Folder name/subfolder/subsubfolder"].
If no path is provided, then the root directory itself is used.
Why isn’t my video shown?
The plugin only shows videos that can be played by the browser. Unfortunately, at the moment, different browsers support different video formats. If you want the best support, we recommend using MP4. Detailed information about which formats are supported by each browser can be found on Wikipedia.
Unfortunately, this is a limitation of Google apps in testing mode, see Google’s documentation. To circumvent this, set your app as either “Internal” or “In Production”.
I’m getting an unknown error
Please enable WordPress debugging to see more information and open a support ticket if relevant.
I’m getting the error `refresh token must be passed in or set as part of setAccessToken`
This error happens for a small fraction of Google apps for an unknown reason. Please delete and recreate the application in the Google developer console.
Contributors & Developers
“Image and video gallery from Google Drive” is open source software. The following people have contributed to this plugin.Contributors
“Image and video gallery from Google Drive” has been translated into 4 locales. Thank you to the translators for their contributions.
Interested in development?
- Fixed big galleries triggering Google API batch request size limit
- Fixed toggle labels in block settings override
- Fixed an error when selecting plugin root directory and navigating to the Drive list
- Fixed a PHP 5 compatibility regression
- Improved error reporting, including a stack trace when in debug mode
- Fixed an issue with galleries sometimes erroneously being reported as empty when images were ordered by time
- Fixed an issue with multiple galleries on the same page
- Fixed an error on incomplete Google API response
- Fixed a PHP warning on images without a timestamp
- Optimized JS code bundling and minimization
- Fixed an issue with WordPress script localization
- Fixed galleries with leading or trailing spaces in names
- Added support for private videos and videos over 25MB
- Hidden videos with missing thumbnail
- Dropped support for Internet Explorer 8
- Fixed an issue where the plugin would break in rare cases of corrupted video files
- Officially added support for PHP 8.1 and WordPress 5.9
- Fixed a bug where pages would get added to the gallery infinitely
- Printing all errors when WordPress is set to debug
- Fixed an issue breaking gallery displaying in 2.11.2
- Fixed a minor collision with some other plugins
- PHP 8.1 compatibility
- Better error handling when the root path contains a Shared Drive that no longer exists
- Fixed the root directory selector, especially in cases when the root dir is invalid
- New icon and assets
- Bundling dependencies in a more robust way
- Erased Google Drive logo from all wordpress.org assets. All new assets will be coming in a following version
- Fixed a possible incompatibility with some other plugins which use the Google API
- Fixed galleries being incorrectly reported as empty
- PHP 8 and WordPress 5.6 support
- Better error handling
- Substantially reduced occurrence of rate limit errors
- Better error handling
- Moved the plugin block under the “media” category
- Fixed an issue where additional pages may not get loaded in an edge case
- Upgraded a dependency to prevent a possible security issue
- Added support for Google Drive shortcuts to folders (image/video shortcuts coming in a future version)
- Improved error handling in the plugin shortcode & block
- Improved handling of corrupted videos
- Fixed missing space in gallery breadcrumbs
- Fixed turning off JS events, breaking e.g. sticky headers
- Fixed missing vendor files, causing errors for some users
- Partially fixed videos: Videos which have permissions set to “Anyone on the internet with this link can view” will now work again correctly. Fix for private videos coming in a later version
- Fixed fatal error for users without the mbstring PHP extension
- Fixed fatal error for users without the intl and idn PHP extensions
- Re-release of the changes from version 2.7.5
- Fixed handling of HTTP request exceptions
- Tested on WordPress 5.4
- Rollback of version 2.7.5, identical to version 2.7.4
- Fixed handling of HTTP request exceptions
- Fixed a bug in ordering options causing some issues primarily when ordering by name
- Reverted a dependency update causing issues and PHP version incompatibility
- Checking JS with TypeScript
- JS and CSS is now minified in the plugin, original sources available in the repository
- Fixed issue with TinyMCE plugin table overflowing the thickbox
- Handling Google errors in root selection when changing user account
- Handling Google errors in gallery enqueueing
- Refactored all JS code
- Fixed issue with & in folder name
- Fixed a bug causing galleries not to load
- Slightly tweaked the grid layout
- Added video support
- Documented all of the source code
- Incorporated updates to Google Drive and its API, namely the rebranding of Team Drives as Shared drives
- Added support for image captions sourced from the “description” field in Google Drive
- Added more quality control with more still to follow
- Added support for pagination of gallery items with configurable page size and optional (enabled by default) autoloading
- Added option to hide a part (a prefix to be more precise) of folder names. This is useful when folders are ordered by name to define own custom ordering
- Added more checks to plugin options to ensure they can’t break it
- Enabled support for caching plugins
- Added the option to override some settings for individual galleries using shortcode attributes or the Gutenberg block
- Fixed loading indicator styling inconsistency
- Fixed lightbox arrow styling on some templates
- Better error reporting for Root selection, TinyMCE and Gutenberg plugins
- Better loading animation
- Clickable breadcrumbs in Root selection, TinyMCE and Gutenberg plugins
- Updated basic settings to reflect changes to the Google developer console
- Fixed error with multiple blocks not working
- Image ordering by time now uses EXIF DateTime
- Partially fixed issue with URL being overridden when not terminated by a slash
- Fixed imprecise directory item counts
- Fixed issue with other plugins overriding styles
- Fixed issue 82
- Fixed potential collision with global composer
- Directory item counts with icons instead of text
- Added more error messages
- Fixed infinite spinner on empty gallery
- Not displaying empty subgalleries
- Fixed more problems with the justified layout
- Open images now have a unique and permanent address so a link to a particular image can be copied and sent
- Fixed multiple galleries in one page
- Fixed some aspect ratios getting squished
- Not displaying breadcrumbs when there is nowhere to navigate
- Fixed an issue with images not being displayed
- Galleries loading with AJAX
- Dark theme
- Using Flickr-style justified layout
- Performance optimisations for subdirectories
- Fixed missing ordering options
- Moved settings to 2 top-level pages
- Changed the Google API redirect URI
- Handling unauthorized plugin in Block & Shortcode
- Fixed error with Gutenberg block overwriting its configuration
- Added proper support for dynamic columns
- Added a Gutenberg block
- Added the option to order images and directories (separately) – by time or name, ascending or descending
- Added graphical editor for TinyMCE
- The first version
- Required WordPress 4.9.6 and higher
- Required PHP 5.6 and higher