Description
Installation
Installation from within WordPress
-
Visit Plugins > Add New . -
Search for Performance Lab . -
Install and activate the Performance Lab plugin.
Manual installation
-
Upload the entire performance-lab folder to the /wp-content/plugins/ directory. -
Visit Plugins . -
Activate the Performance Lab plugin.
After activation
-
Visit the new Settings > Performance menu. -
Enable the individual features you would like to use.
FAQ
-
What is the purpose of this plugin? -
The primary purpose of the Performance Lab plugin is to allow testing of various performance features for which the goal is to eventually land in WordPress core. It is essentially a collection of “feature plugins”, which makes it different from other performance plugins that offer performance features which are not targeted at WordPress core and potentially rely on functionality that would not be feasible to use in WordPress core. The list of available features will regularly change: Existing features may be removed after they have been released in WordPress core, while new features may be added in any release. -
Can I use this plugin on my production site? -
Per the primary purpose of the plugin (see above), it can mostly be considered a beta testing plugin for the various performance features it includes. However, it’s essential to understand that utilizing it comes with inherent risks. Users are encouraged to proceed with caution and understand that they are doing so at their own risk. -
Where can I submit my plugin feedback? -
Feedback is encouraged and much appreciated, especially since this plugin is a collection of future WordPress core features. If you have suggestions or requests for new features, you can submit them as an issue in the Performance Lab GitHub repository . If you need help with troubleshooting or have a question about the plugin, please create a new topic on our support forum . -
Where can I report security bugs? -
The Performance team and WordPress community take security bugs seriously. We appreciate your efforts to responsibly disclose your findings, and will make every effort to acknowledge your contributions. To report a security issue, please visit the WordPress HackerOne program. -
How can I contribute to the plugin? -
Contributions are always welcome! Learn more about how to get involved in the Core Performance Team Handbook .
Reviews
Contributors & Developers
Interested in development?
Changelog
3.1.0
-
Add progress indicator when activating a feature. ( one thousand one hundred and ninety ) -
Display plugin settings links in the features screen and fix responsive layout for mobile. ( one thousand two hundred and eight ) -
Add plugin dependency support for activating performance features. ( one thousand one hundred and eighty-four ) -
Add support for AVIF image format in site health. ( one thousand one hundred and seventy-seven ) -
Add server timing to REST API response. ( one thousand two hundred and six ) -
Bump minimum PHP requirement to 7.2. ( one thousand one hundred and thirty ) -
Refine logic in perflab_install_activate_plugin_callback() to rely only on validated slug. ( one thousand one hundred and seventy ) -
Improve overall code quality with stricter static analysis checks. ( seven hundred and seventy-five )
-
Avoid passing incomplete data to perflab_render_plugin_card() and show error when plugin directory API query fails. ( one thousand one hundred and seventy-five ) -
Do not show admin pointer on the Performance screen and dismiss the pointer when visited. ( one thousand one hundred and forty-seven ) -
Fix WordPress.DB.DirectDatabaseQuery.DirectQuery warning for Autoloaded Options Health Check. ( one thousand one hundred and seventy-nine )
3.0.0
-
Add caching to the wordpress.org query to get plugin information. ( one thousand and twenty-two ) -
Add support for autoloading enhancements in WordPress 6.6 trunk to autoloaded options Site Health check. ( one thousand one hundred and twelve ) -
Bump minimum required WordPress version to 6.4. ( one thousand and sixty-two ) -
Enhance object-cache.php drop-in placement logic to support updating to a newer version of the file. ( one thousand and forty-seven ) -
Implement support for annotating certain plugins as experimental. ( one thousand one hundred and eleven ) -
Migrate Site Health checks from being modules to becoming part of the plugin core. ( one thousand and forty-two ) -
Remove modules infrastructure and UI from the plugin. ( one thousand and sixty ) -
Support changing autoload value for largest autoloaded options in Site Health check. ( one thousand and forty-eight ) -
Use plugin slug for generator tag. ( one thousand one hundred and three )
-
Update tested WordPress version to 6.5. ( one thousand and twenty-seven )
2.9.0
-
Infrastructure: Add standalone plugin version constants for auto-sizes and speculation-rules. ( nine hundred and fifty-eight )
-
Infrastructure: Include standalone plugin slugs in generator tag. ( nine hundred and forty-nine )
-
Infrastructure: Sanitize metric name for Server-Timing header. ( nine hundred and fifty-seven )
2.8.0
-
Infrastructure: Introduce UI for managing Performance Lab standalone plugins. ( eight hundred and sixty-four )
-
Infrastructure: Add support for plugin live preview in the plugin directory. ( eight hundred and ninety ) -
Infrastructure: Allow module can-load.php callbacks to return a WP_Error with more information. ( eight hundred and ninety-one ) -
Infrastructure: Implement admin pointer to indicate to the user they need to migrate modules to their standalone plugins. ( nine hundred and ten ) -
Infrastructure: Implement migration logic and UI from Performance Lab modules to their standalone plugins. ( eight hundred and ninety-nine ) -
Infrastructure: Reset admin pointer dismissal for module migration when the user activates a module. ( nine hundred and fifteen )
-
Infrastructure: Fix construction of translation strings in admin/plugins.php. ( nine hundred and twenty-five )
2.7.0
-
Images: Remove Fetchpriority module as the functionality is now available in WordPress core. ( eight hundred and fifty-four ) -
Infrastructure: Bump minimum required PHP version to 7.0 and minimum required WP version to 6.3. ( eight hundred and fifty-one )
-
Infrastructure: Publish Image Placeholders standalone plugin. ( eight hundred and forty-two )
2.6.1
-
Infrastructure: Remove PHPStan config file from plugin directory. ( eight hundred and sixteen )
-
Infrastructure: Add standalone plugin assets. ( eight hundred and fifteen )
2.6.0
-
Infrastructure: Add output buffering checkbox to Server-Timing screen. ( eight hundred and one ) -
Infrastructure: Implement logic to measure specific hook execution time with Server-Timing controlled by a WP Admin screen. ( seven hundred and eighty-four )
-
Images: Fix incorrect function prefixes in Image Placeholders. ( seven hundred and eighty-nine ) -
Infrastructure: Add early exit clauses to files with procedural code. ( seven hundred and ninety ) -
Infrastructure: Allow disabling Server-Timing entirely using PERFLAB_DISABLE_SERVER_TIMING constant. ( seven hundred and ninety-five )
-
Images: Fix WebP handling when editing images based on WordPress 6.3 change. ( seven hundred and ninety-six ) -
Infrastructure: Fix errors detected by Plugin Checker. ( seven hundred and eighty-eight )
2.5.0
-
Images: Check for fetchpriority feature being available in WordPress core before loading the module. ( seven hundred and sixty-nine ) -
Database Optimization: Remove SQLite module. ( seven hundred and sixty-four ) -
Infrastructure: Bump tested up to version to 6.3. ( seven hundred and seventy-two )
2.4.0
-
Database: Implement migration prompt to migrate from SQLite module to standalone plugin due to removal in the following release. ( seven hundred and thirty-nine ) -
Infrastructure: Enhance code quality by adding PHPStan and fixing level 0 issues. ( seven hundred and thirty ) -
Infrastructure: Use static closures for minor performance improvement whenever instance access is not needed. ( seven hundred and twenty-nine )
-
Database: Fix SQLite module deactivation routine to make standalone plugin migration work correctly. ( seven hundred and forty-three ) -
Infrastructure: Make Server-Timing header output more robust. ( seven hundred and thirty-six )
2.3.0
-
Images: Configure Dominant Color and Fetchpriority modules for their standalone plugins. ( seven hundred and four ) -
Infrastructure: Temporarily remove Image Placeholders from standalone plugins.json definition. ( seven hundred and nineteen ) -
Infrastructure: Use dynamic version from plugins.json for manual workflow. ( seven hundred and ten )
-
Images: Add dominant color styling before any existing inline style attributes. ( seven hundred and sixteen ) -
Infrastructure: Resolve low-severity security advisory GHSA-66qq-69rw-6×63 .
2.2.0
-
Images: Remove “experimental” flag from Fetchpriority module. ( seven hundred and two ) -
Infrastructure: Implement infrastructure for launching standalone plugins from modules, including Modern Image Formats. ( six hundred and ninety-nine ) -
Infrastructure: Include WordPress-Extra rules in PHPCS configuration and fix resulting problems. ( six hundred and ninety-five )
-
Images: Sanitize target param before using it. ( six hundred and ninety )
-
Images: Change module slug/directory from dominant-color to dominant-color-images . ( seven hundred and eight ) -
Images: Rename Dominant Color module to Dominant Color images . ( seven hundred and five )
2.1.0
-
Infrastructure: Add wp-total metric to default Server-Timing metrics. ( six hundred and sixty-nine ) -
Infrastructure: Ensure module load.php files really only load other code to prevent conflicts in standalone plugins. ( six hundred and seventy-four )
-
Infrastructure: Fix problems with placing object-cache.php drop-in. ( six hundred and seventy-two )
2.0.0
-
Object Cache: Update WordPress version to 6.1 and remove Cache modules. ( six hundred and forty-one ) -
Measurement: Add perflab_disable_object_cache_dropin filter. ( six hundred and twenty-nine ) -
Database: Add an indicator in the adminbar to show when using SQLite. ( six hundred and four )
-
Images: Check for existing $metadata['sizes'] to fix PHP warning. ( six hundred and forty-eight ) -
Images: Use correct number of arguments in filter callback. ( six hundred and thirty-four ) -
Database: Fix invalid docs and return types as highlighted by static analysis. ( six hundred and forty-five ) -
Infrastructure: Fix incorrect usage of plugin_action_links_* filter. ( six hundred and forty-seven )
-
Infrastructure: Add file header to object-cache drop-in to clarify purpose. ( six hundred and forty-nine )
1.9.0
-
Database: Remove warning about multi-server environment from the SQLite module description. ( six hundred and nineteen )
-
Infrastructure: Enhance object-cache.php drop-in interoperability with other plugins. ( six hundred and sixteen )
1.8.0
-
Measurement: Implement Server-Timing API foundation as well as basic load time metrics. ( five hundred and fifty-three ) -
Database: Implement new experimental SQLite integration module. ( five hundred and forty-seven ) -
Images: Implement new experimental fetchpriority module. ( five hundred and twenty-eight )
-
Database: Fix SQLite notices related to undefined properties. ( six hundred ) -
Database: Fix incorrect handling of admin_email and actual admin user’s email when original admin_email user was deleted. ( six hundred and three ) -
Database: Make WP filesystem setup more robust to prevent potential errors. ( five hundred and ninety-five )
1.7.0
-
Images: Change WP Image editor quality for mime types. ( five hundred and seventy-one ) -
Infrastructure: Introduce database focus area, rename JavaScript focus area to JS & CSS, and phase out Site Health focus area. ( five hundred and sixty-six )
-
Images: Avoid potentially adding invalid attributes or duplicates for dominant color images. ( five hundred and seventy-eight ) -
Images: Fix fatal error in REST API response when an image has no attachment metadata. ( five hundred and sixty-eight ) -
Images: Fix image focal point bug when dominant color is enabled by not overriding style attribute. ( five hundred and eighty-two ) -
Images: Fix opt-in checkbox for generating WebP and JPEG to also show on Multisite. ( five hundred and sixty-five )
1.6.0
-
Site Health: Only load Site Health checks for persistent cache and full page cache when not available in core. ( five hundred and forty-three ) -
Images: Add checkbox to Settings > Media to control whether to generate JPEG in addition to WebP. ( five hundred and thirty-seven ) -
Images: Generate only WebP images by default for JPEG and WebP uploads. ( five hundred and twenty-seven ) -
Infrastructure: Bump minimum WordPress requirement to 6.0. ( five hundred and forty-nine )
1.5.0
-
Site Health: Improve autoloaded options check by highlighting largest autoloaded options. ( three hundred and fifty-three )
1.4.0
-
Images: Enhance JS replacement mechanism for WebP to JPEG to more reliably replace full file name. ( four hundred and forty-three ) -
Images: Introduce webp_uploads_get_content_image_mimes() to get content image MIME replacement rules. ( four hundred and twenty ) -
Infrastructure: Add PERFLAB_PLUGIN_DIR_PATH constant for plugin_dir_path() . ( four hundred and twenty-nine ) -
Infrastructure: Rename Site Health check modules for language and consistency. ( four hundred and twenty-three )
-
Site Health: Fix incorrect usage of badge colors in all Site Health checks. ( four hundred and seventy-two ) -
Images: Add the original image’s extension to the WebP file name to ensure it is unique. ( four hundred and forty-four ) -
Images: Fix REST API support for plain permalinks. ( four hundred and fifty-seven ) -
Infrastructure: Remove plugin option network-wide for Multisite during uninstall. ( four hundred and fifty-eight )
1.3.0
-
Images: Add replacing of images only in frontend context. ( four hundred and twenty-four ) -
Images: Allow control for which image sizes to generate additional MIME type versions. ( four hundred and fifteen ) -
Images: Discard WebP image if it is larger than corresponding JPEG image. ( four hundred and eighteen ) -
Images: Optimize computing dominant color and transparency for images by combining the two functions. ( three hundred and eighty-one ) -
Images: Provide fallback JPEG images in frontend when WebP is not supported by the browser. ( three hundred and sixty ) -
Images: Rely on wp_get_image_editor() methods argument to check whether it supports dominant color methods. ( four hundred and four ) -
Images: Remove experimental label from Dominant Color module and turn on by default for new installs. ( four hundred and twenty-five ) -
Site Health: Remove perflab_aea_get_resource_file_size() in favor of wp_filesize() . ( three hundred and eighty ) -
Site Health: Update documentation link for autoloaded options. ( four hundred and eight ) -
Infrastructure: Implement mechanism to not load module if core version is available. ( three hundred and ninety )
-
Images: Ensure incorrect usage of webp_uploads_upload_image_mime_transforms filter is treated correctly. ( three hundred and ninety-three ) -
Images: Fix PHP notice and bug in logic for when webp_uploads_prefer_smaller_image_file filter is set to true . ( three hundred and ninety-seven ) -
Images: Fix an infinite loop in the WebP fallback mechanism. ( four hundred and thirty-three ) -
Images: Fix dominant color upload process to not override potential third-party editors. ( four hundred and one ) -
Images: Remove additional image backup sources & sizes files when attachment deleted. ( four hundred and eleven ) -
Infrastructure: Avoid including .husky directory in plugin ZIP. ( four hundred and twenty-one ) -
Infrastructure: Do not show admin pointer in multisite Network Admin. ( three hundred and ninety-four )
1.2.0
-
Images: Add Dominant Color module to provide color background for loading images. ( two hundred and eighty-two ) -
Site Health: Add Site Health check for Full Page Cache usage. ( two hundred and sixty-three )
-
Images: Update webp_uploads_pre_generate_additional_image_source filter to allow returning file size. ( three hundred and thirty-four ) -
Infrastructure: Introduce plugin uninstaller routine. ( three hundred and forty-five ) -
Infrastructure: Use wp_filesize instead of filesize if available. ( three hundred and seventy-six )
-
Images: Avoid overwriting existing WebP files when creating WebP images. ( three hundred and fifty-nine ) -
Images: Back up edited full image sources when restoring the original image. ( three hundred and fourteen )
1.1.0
-
Infrastructure: Add Performance Lab generator meta tag to wp_head output. ( three hundred and twenty-two )
-
Images: Introduce filter webp_uploads_pre_generate_additional_image_source to short-circuit generating additional image sources on upload. ( three hundred and eighteen ) -
Images: Introduce filter webp_uploads_pre_replace_additional_image_source to short-circuit replacing additional image sources in frontend content. ( three hundred and nineteen ) -
Images: Refine logic to select smaller image file in the frontend based on webp_uploads_prefer_smaller_image_file filter. ( three hundred and two ) -
Images: Replace the featured image with WebP version when available. ( three hundred and sixteen ) -
Site Health: Update Site Health Autoloaded options documentation link. ( three hundred and thirteen ) -
Infrastructure: Avoid unnecessarily early escape of Site Health check labels. ( three hundred and thirty-two )
-
Object Cache: Correct label for persistent object cache Site Health check. ( three hundred and twenty-nine ) -
Images: Only update the specified target images when an image is edited. ( three hundred and one )
1.0.0
-
Images: Generate secondary image MIME types when editing original image. ( two hundred and thirty-five )
-
Images: Introduce webp_uploads_prefer_smaller_image_file filter allowing to opt in to preferring the smaller image file. ( two hundred and eighty-seven ) -
Images: Select MIME type to use in frontend content based on file size. ( two hundred and forty-three ) -
Site Health: Update Site Health reports copy for more clarity and consistency. ( two hundred and seventy-two )
-
Infrastructure: Define the plugin’s version support and backward compatibility policy. ( two hundred and forty )
1.0.0-rc.1
-
Images: Change expected order of items in the webp_uploads_content_image_mimes filter. ( two hundred and fifty ) -
Images: Replace images in frontend content without using an additional regular expression. ( two hundred and sixty-two ) -
Images: Restore and backup image sizes alongside the sources properties. ( two hundred and forty-two )
-
Images: Select image editor based on WebP support instead of always using the default one. ( two hundred and fifty-nine )
1.0.0-beta.3
-
Infrastructure: Ensure default modules are loaded regardless of setting registration. ( two hundred and forty-eight )
1.0.0-beta.2
-
Images: Create additional MIME types for the full size image. ( one hundred and ninety-four ) -
Site Health: Add module to warn about excessive amount of autoloaded options. ( one hundred and twenty-four )
-
Images: Adds sources information to the attachment media details of the REST response. ( two hundred and twenty-four ) -
Images: Allow developers to select which image format to use for images in the content. ( two hundred and thirty ) -
Images: Allow developers to tweak which image formats to generate on upload. ( two hundred and twenty-seven ) -
Images: Replace the full size image in the_content with additional MIME type if available. ( one hundred and ninety-five ) -
Object Cache: Include memcached extension in checks for object cache support. ( two hundred and six ) -
Infrastructure: Add plugin banner and icon assets. ( two hundred and thirty-one ) -
Infrastructure: Use .gitattributes instead of .distignore to better support ZIP creation. ( two hundred and twenty-three )
-
Images: Use original image to generate all additional image format sub-sizes. ( two hundred and seven ) -
Infrastructure: Replace unreliable activation hook with default value for enabled modules. ( two hundred and twenty-two )
-
Infrastructure: Update release instructions to include proper branching strategy and protect release branches. ( two hundred and twenty-one )
1.0.0-beta.1
-
Images: Add WebP for uploads module. ( thirty-two ) -
Images: Support retry mechanism for generating sub-sizes in additional MIME types on constrained environments. ( one hundred and eighty-eight ) -
Images: Update the_content with the appropriate image format. ( one hundred and fifty-two ) -
Site Health: Add WebP support in site health. ( one hundred and forty-one ) -
Site Health: Add module to alert about excessive JS and CSS assets. ( fifty-four ) -
Object Cache: Add Site Health check module for persistent object cache. ( one hundred and eleven ) -
Infrastructure: Add settings screen to toggle modules. ( thirty ) -
Infrastructure: Added admin pointer. ( one hundred and ninety-nine )
-
Object Cache: Always recommend object cache on multisite. ( two hundred ) -
Images: Create image sub-sizes in additional MIME types using sources for storage. ( one hundred and forty-seven ) -
Images: Update module directories to be within their focus directory. ( fifty-eight ) -
Site Health: Enhance detection of enqueued frontend assets. ( one hundred and thirty-six ) -
Infrastructure: Add link to Settings screen to the plugin’s entry in plugins list table. ( one hundred and ninety-seven ) -
Infrastructure: Enable all non-experimental modules on plugin activation. ( one hundred and ninety-one ) -
Infrastructure: Include generated module-i18n.php file in repository. ( one hundred and ninety-six ) -
Infrastructure: Introduce perflab_active_modules filter to control which modules are active. ( eighty-seven ) -
Infrastructure: Remove unnecessary question marks from checkbox labels. ( one hundred and ten ) -
Infrastructure: Rename object-caching to object-cache . ( one hundred and eight )
-
Images: Ensure the -scaled image remains in the original uploaded format. ( one hundred and forty-three ) -
Images: Fix typo to access to the correct image properties. ( two hundred and three ) -
Infrastructure: Ensure that module header fields can be translated. ( sixty )
-
Site Health: Mark Site Health Audit Enqueued Assets module as experimental for now. ( two hundred and five ) -
Infrastructure: Add readme.txt and related update script. ( seventy-two ) -
Infrastructure: Add changelog generator script. ( fifty-one ) -
Infrastructure: Add contribution documentation. ( forty-seven ) -
Infrastructure: Add release documentation. ( one hundred and thirty-eight ) -
Infrastructure: Define module specification in documentation. ( twenty-six )