Back to Community
Home / Community / Core → Fixing wordpress

Resolving the WooCommerce Setup Wizard Loop: A Step-by-Step Guide

31 threads Sep 7, 2025 Core → Fixing wordpress

Content

Many WordPress site builders have encountered a particularly frustrating issue: the WooCommerce setup wizard that just won't go away. You complete the initial store setup, click the WooCommerce home link, and find yourself right back at the beginning of the wizard. This 'WooCommerce Wizard Loop' can prevent you from accessing your store's dashboard and managing your products.

Why Does This Happen?

Based on community reports, the core of this issue often lies in a persistent URL parameter. After setup, the link to the WooCommerce home area incorrectly includes &path=%2Fsetup-wizard at the end of the URL. This parameter tells WooCommerce to launch the setup wizard again, creating an endless loop. The problem is not with your setup, but rather a bug where WooCommerce fails to remove this parameter from its internal navigation links.

How to Break the Loop: Immediate and Long-Term Fixes

1. The Manual URL Fix (Quick Workaround)

This is a temporary fix to regain access to your dashboard.

  1. Navigate to your WordPress admin area.
  2. Click on the 'WooCommerce' link in the left-hand menu. You will be taken to a URL that looks like: .../admin.php?page=wc-admin&path=%2Fsetup-wizard
  3. Manually delete the &path=%2Fsetup-wizard part from your browser's address bar and press Enter.
  4. You should now see the standard WooCommerce dashboard homepage instead of the setup wizard.

Note: This is only a temporary solution. The loop will likely return the next time you click a WooCommerce admin link.

2. Clear Transient Data (More Permanent Fix)

The wizard's completion status is often stored in your site's transient data. Corrupted or stuck transients can cause this loop.

  1. Install and activate a reputable database management plugin like "WP-Optimize" or "Advanced Database Cleaner."
  2. Use the plugin to safely clear all transient data (expired transients and all transients).
  3. Deactivate and reactivate the WooCommerce plugin. This can sometimes trigger a reset of its internal state.
  4. Check if the wizard loop has been resolved.

3. The Definitive Code Fix

For a permanent solution, you can add a small code snippet to your site's functions.php file. This code will programmatically mark the setup wizard as completed.

Warning: Always back up your site before editing theme files.

  1. In your WordPress dashboard, go to Appearance > Theme File Editor.
  2. Select your active theme (a child theme is highly recommended for this).
  3. On the right-hand side, click on Theme Functions (functions.php).
  4. Add the following code at the very bottom of the file: 
    // Permanently disable the WooCommerce setup wizard redirect
add_action( 'admin_init', 'disable_wc_setup_wizard_loop' );
function disable_wc_setup_wizard_loop() {
    if ( false !== get_option( 'woocommerce_task_list_hidden' ) ) {
        // Do nothing if the task list is already hidden
        return;
    }
    // Mark the task list as hidden and complete the setup
    update_option( 'woocommerce_task_list_hidden', 'yes' );
    update_option( 'woocommerce_task_list_complete', 'yes' );
    update_option( 'woocommerce_onboarding_profile', array( 'completed' => true ) );
}
  5. Click Update File.
  6. Refresh your WooCommerce admin page. The wizard should be gone.
  7. Important: After confirming the fix works, you can remove this code snippet to keep your functions.php file clean, as it has already done its job by updating the necessary options in the database.

When to Seek Further Help

If none of the above solutions work, the issue could be related to a deeper plugin or theme conflict.

  1. Conflict Test: Temporarily switch to a default WordPress theme like Twenty Twenty-Four and disable all plugins except WooCommerce. If the loop stops, reactivate your plugins one by one to identify the culprit.
  2. Community Support: Since this is a issue with the WooCommerce plugin itself, the best place for further assistance is the official WooCommerce support forums on WordPress.org. Be sure to describe the steps you've already taken.

This persistent loop is a known pain point for many users. By following these steps, you should be able to break the cycle and get back to managing your store efficiently.

Related Support Threads Support