This section covers all the steps for troubleshooting the Version Info WordPress plugin.

Troubleshooting

Version Info is designed to be extremely lightweight and conflict-free. However, as with any software, issues can occasionally arise. This guide covers the most common scenarios and how to resolve them.

General Troubleshooting Steps

If you encounter any issues, please follow these steps:

1. Ensure you're using the latest version of A) the Version Info plugin, B) WordPress, and C) PHP. Before updating, you should always have a backup of your site available.
2. Clear the cache at all levels to ensure you're seeing the latest version of your dashboard (possible caching may include server-side, website via caching plugins, CDN, and browser caching).
3. Temporarily disable all other plugins and activate a default WordPress theme. If that resolves the issue, reactivate plugins one-by-one to identify the conflict.

Common Issues

Version data not appearing in the admin footer

• Navigate to Settings > Version Info and confirm that "Show in Admin Footer" is enabled.
• Check if another plugin or theme is overriding the admin_footer_text filter. Version Info hooks into this filter at the default priority.

Admin bar nodes not showing

• Navigate to Settings > Version Info and confirm that "Show in Admin Bar" is enabled.
• Ensure the WordPress admin bar is visible (check Users > Your Profile > Show Toolbar when viewing site).

Dashboard widget not appearing

• Navigate to Settings > Version Info and confirm that "Show Dashboard Widget" is enabled.
• Check if the widget has been hidden via Screen Options on the Dashboard page. Click the "Screen Options" tab at the top of the Dashboard and ensure "Version Info" is checked.

PRO features appear grayed out after upgrading

• Verify your license is active by navigating to Settings > Version Info > Account in the Freemius menu.
• If your license shows as inactive, click Activate License and enter your license key.
• Clear any object cache or persistent cache on your site after activation.

CPU/RAM monitoring shows no data (PRO)

• The sys_getloadavg() function must be available on your server. Some shared hosting providers disable this function.
• Memory monitoring reads from /proc/meminfo on Linux systems. Windows servers use WMI as a fallback.
• Ensure the WordPress Heartbeat API is not disabled by another plugin or your hosting provider.

Environment badge not displaying (PRO)

• Ensure at least one environment constant is defined. Version Info checks for WP_ENVIRONMENT_TYPE, WP_ENV, and host-specific constants (Kinsta, WP Engine, Pantheon, Flywheel).
• If no constant is detected, the environment defaults to "Production."

Database size showing as cached data (PRO)

• Database size is cached for 12 hours to minimize server load. Click the Scan Now button on the System Resources tab to force a fresh scan.

Role-Based Access Issues (Agency)

If a user role cannot see Version Info data:

• Navigate to Settings > Version Info > Access Control and verify the role is listed in the allowed roles.
• Administrators always have access and cannot be removed from the allowed list.

Opening a Support Ticket

Our support team is available Mon - Fri. We strive to respond to all requests within 24 hours, excluding weekends. You can open a support ticket at versioninfoplugin.com/support/.

When opening a support ticket, please provide:

1. Confirm you've attempted all troubleshooting steps above. [Required]
2. A screenshot or description of the issue, including any error messages. [Required]
3. Your current environment details (these are conveniently available right from Version Info!):
4. PHP Version
5. WordPress Version
6. MySQL Version
7. Web Server
8. Version Info plugin version
9. A list of other active plugins on the site. [Recommended]
10. WP-Admin login access via a temporary login plugin. [Optional]