---
title: "Troubleshooting"
description: "This section covers all the steps for troubleshooting the Version Info WordPress plugin."
url: "https://docs.versioninfoplugin.com/getting-started-troubleshooting/"
---
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.

Some security or performance plugins may interfere with WordPress AJAX endpoints or the Heartbeat API, which are used by Version Info PRO for real-time resource monitoring. If resource data isn't updating, check for plugins that restrict these features.

### 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/](https://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\]

**PRO Tip**: If you have Version Info PRO, use the **System Info Export** feature to generate a JSON file of your entire environment. Attach this to your support ticket for the fastest possible resolution.
