Solving WordPress Issues: A DIY Guide to Troubleshooting

WordPress plugins and themes may have flaws or bugs, which cannot always be prevented. Dealing with them can be really frustrating, but you do not always need to contact support or hire someone to fix it.

Problems with WordPress that are causing your site to crash and lose visitors are annoying can be difficult to fix. In such situation, you can try changing to a different plugin or theme, or updating them to see if that solves the problem.

If nothing changes, you will need to ask the plugin or theme support team for help. Waiting for their reply can be stressful, especially if your site is down and you are losing traffic and potential customers.

In this short article, you will find a few tips and suggestions that can speed up the process and resolve your issue quicker.

Troubleshooting Common Issues Before Contacting Support

Before contacting help, there are certain steps you may take to solve the problem yourself. This may often resolve the problem, which will save you and the support team a lot of time.

Sometimes, solving the problem on your own can be much faster than asking anyone for help. Here are a few basic things that you can try.

Check for Plugin & Theme Conflicts

If you think a specific plugin might be causing the problem, try deactivating it. Once you see the problem is fixed, it is highly likely that this was the source of the issue. At that point, you can:

  1. Update the Plugin
    Make sure that you are using the latest version
  2. Contact the Plugin Developer
    If the issue persists even after updating, report the issue/bug the plugin’s support team.
  3. Find an Alternative Plugin
    Consider switching to a different plugin with similar functionality.

In case deactivating the plugin still does not solve your issue, reactivate it and check the other plugins one by one to identify which one is breaking your website.

Clear Frontend Cache

Caching is a common cause of WordPress issues, when visual changes to your website are not showing up as expected in front-end. It can help your website load faster by storing and preloading static content like images, HTML, JS, and CSS files.

However, this can sometimes lead to outdated content being displayed and may also have an impact on the redirection functions. Here are a few steps you can take to address caching-related problems:

  1. Clear Your Browser Cache
    Your browser can store a local copy of websites you visited before to load them faster next time. Sometimes the website's content changes before your browser decides to refresh it automatically, but you can manually flush the cache in just a few clicks.
  2. Flush Your WordPress Caching Plugin
    If you are using a caching plugin like WP Super Cache, W3 Total Cache, or LiteSpeed Cache, you can also try to flush its cached data. Most of the plugins have a dedicated clear cache button available in their settings or in the WordPress admin toolbar.
  3. Purge Server and CDN Cache
    Certain hosting providers offer server-level caching, which can cause similar issues. Hosts like SiteGround, WP Engine, or Bluehost often include a button to purge the cache directly. To find it, check your hosting provider’s control panel and look for a "cache" section.

Look for Information in Official Documentation or Forums

Many plugins and themes provide online resources such as forums, documentation pages, or knowledge bases. Developers usually address the most commonly reported issues in a "FAQ" or "Common Issues" section.

It is possible that someone else has already reported the similar issue, therefore there may be instructions on how to solve it. In some cases, all it takes to fix the problem is changing the configuration or the insertion of a code snippet.

Submitting the Support Request

If you have have exhausted your own troubleshooting methods, it is time to contact a plugin or theme developer. The process of sending support requests is straightforward for most WordPress plugins and themes. Therefore we will not go into too much detail about the process itself.

Free and Paid Plugins/Themes

The support channel depends on whether you purchased a plugin or theme or downloaded it for free. Most developers offer a dedicated support channel, such as a ticket system or a support forum.

If you are having problem with a free plugin or theme, there may be a dedicated support forum in the WordPress.org repository available.

Support forum for "Permalink Manager Lite" users
Support forum for "Permalink Manager Lite" users

Understand the Developer's Perspective

For many, the first reaction to any sort of difficulty is to become frustrated. This may be even more aggravating if it is related to the paid software. You have every right to expect the developers to "fix it" if you feel this way.

Empathy and respect for those who wants to help really can make a difference. Support team members, like everyone else, are human beings. They are, without a doubt, aware of your irritation and really want to solve your problem.

Keep in mind that they get multiple support requests every day. Therefore, by giving them clear information you can save both their and your time.

The person who receives your request cannot see your screen or know what steps you took before the problem occurred. They can understand the problem and offer a solution based only on the information you gave them.

Best Practices for Submitting a Support Ticket

Your problem will be fixed as quickly as the developer can make sense of the details you provide them. You may save yourself and the developer time by providing all the relevant information from the start.

Clearly Describe the Problem and Give the Background

To begin, please describe the problem you are having as precisely and straightforwardly as possible. Remember that the main objective is to provide a clear picture of the problem so that the developer can reproduce it and come up with a fix.

First, explain what exactly went wrong and what you expected to happen instead. It is always a good idea to let the developer know what solutions you have already tried. This way, you can avoid wasting time on solutions you have already ruled out.

Collect Information About Your WordPress Site

Sometimes, after updating a plugin or theme, new bugs can appear. If you ask for support, please include some basic information about your server and WordPress setup, such as a list of active plugins.

You can find them easily in the "Site Health" report directly in your admin dashboard.

If you suspect that two plugins are conflicting, there might be an update available that fixes the issue. Try updating both, and if that does not solve the problem, please mention the version numbers.

Attach Screenshots or Video

If you are not confident in your writing abilities or struggle with English, consider using screenshots or video to better explain the issue. When you are looking for support, a picture really does speak a thousand words.

Please make sure that any screenshots or videos you take to illustrate the problem adequately describe its context. They need to allow the support staff to fully comprehend the problem.

You will not always be able to attach media files to support tickets. In such situation, simply use a free image/video hosting service, such as Imgur.com, and paste the URL of the media file to the message.

Share Error Messages or Logs

If you spot any PHP error messages or have access to server logs, send them with your support request. The fragments of error logs may help developers in determining the source of the problem.

You need to activate debug mode in WordPress in order to see PHP problems and warnings. If you do not know how, I covered it in a separate article.

What Information to Include in a WordPress Support Request

Site Health Report

Site Health, which debuted with WordPress 5.2, is a useful tool for assessing your site's performance. You may also use it to determine whether anything requires your urgent attention.

When you write a message to a support team, it would be really great if include information about your website's setup. Naturally, you can manually find and collect all necessary data on PHP, WordPress version, and installed plugins.

There is, however, a better and much faster way. You can simply share the Site Health data with the support team! To access the "Site Health", simply navigate to the "Tools" section in your admin dashboard and select it from the sidebar menu.

"Site Health" main screen

You will notice two tabs: "Status" and "Info" when you get there. The first, "Status" will provide you general advice on how to improve and fix your WordPress site. However, the information we want is under the second tab, named "Info".

Now, click the "Copy site info to clipboard" button and paste the copied information into an email or support ticket.

"Site Health" Info section

Browser's Console Log

Frequently, especially with page builders like Gutenberg or Elementor, interface elements or do not work in the admin panel. If you are experiencing this, there may be a problem with JavaScript or a plugins conflict. This might also be the case if the slider, buttons, or other elements are not working properly on the front-end.

Fortunately, all widely used browsers provide developer tools that may be used to identify such problems. You may use them to take a screenshot of the console log from your browser and attach it to your support request. This could help the developers in tracking down and addressing the issue you are experiencing.

Firefox Developer Tools
Data from the browser's console log can be used to resolve JS-related problems and plugin incompatibilities.
by Maciej Bis

Leave a Reply

Your email address will not be published. Required fields are marked *