E-commerce & Monetization

Install WooCommerce Guide

Step-by-step tutorial to install and configure your first WordPress WooCommerce store.

Want to turn your existing WordPress site into an online store? Installing WooCommerce is the fastest way to add products, carts, and secure checkout without switching platforms or hiring a developer. The good news: you can get the basics running in less than an hour if you follow a clear, structured process.

This guide walks you step by step through how to install WooCommerce, run the setup wizard, configure payments and shipping, and test your first order. The walkthrough is written for site owners using the Classic Editor and themes like Jannah, but it works for most modern WordPress setups.

If you are still unsure how WooCommerce relates to your main site, read the difference between WordPress and WooCommerce first, then come back here to complete the installation.

Prerequisites

Before you install WooCommerce, make sure your hosting, WordPress install, and account permissions are ready. These basics will prevent most “white screen” or “critical error” problems during activation.

  • An existing WordPress site that you can log into as an Administrator.
  • SSL certificate installed (your site loads over HTTPS, not HTTP).
  • PHP and MySQL versions that meet WooCommerce’s current requirements (ask your host if you’re unsure).
  • Pretty permalinks enabled under Settings > Permalinks (Post name is recommended).
  • Recent backup of your WordPress site (files + database).
Warning: Always create a full backup before installing major plugins like WooCommerce, especially on live stores. If something breaks, you’ll be glad you can roll back quickly.

Step 1: Check Hosting and WordPress Requirements

WooCommerce adds database queries, scripts, and extra pages to your site. If your hosting is underpowered or outdated, store performance and checkout reliability will suffer.

  1. Log in to your hosting control panel or contact support to confirm:
    • PHP version meets or exceeds the current WooCommerce recommendation.
    • MySQL / MariaDB versions are supported.
    • Server has sufficient memory (512MB+ recommended for busy stores).
  2. Log in to your WordPress dashboard and go to Dashboard > Updates to update WordPress core, themes, and existing plugins.
  3. Visit Settings > Permalinks and select Post name, then click Save Changes.
Note: If you use the Jannah theme, make sure it’s updated to the latest version so its WooCommerce templates and styles match the current plugin version.

Step 2: Install the WooCommerce Plugin

With your site ready, you can now add WooCommerce from the WordPress plugin repository. This method ensures you get the official plugin from Automattic.

  1. In your WordPress admin, go to Plugins > Add New.
  2. In the search box, type WooCommerce.
  3. Locate the plugin labeled “WooCommerce” by Automattic.
  4. Click Install Now, then click Activate once installation completes.
WordPress Add Plugins screen displaying WooCommerce plugin details, description, version, and the prominent 'Activate' button for installation.
The WooCommerce plugin details are shown on the WordPress dashboard, ready for activation.
Note: Double-check the author is Automattic. Avoid similarly named plugins that may only integrate with WooCommerce instead of providing the main store engine.

If you need a refresher on installing plugins, see this detailed tutorial on how to install a plugin in WordPress before proceeding.

Advanced users comfortable with the command line can install WooCommerce using WP-CLI from an SSH terminal:

wp plugin install woocommerce --activate

Run this command from the root directory of your WordPress installation.

Step 3: Run the WooCommerce Setup Wizard

Immediately after activation, WooCommerce usually launches its setup wizard to help you configure core store settings. If it doesn’t appear, you can access it from WooCommerce > Home and look for the setup tasks panel.

  1. Store details: Enter your business address, city, and country. Choose your main currency and select whether you’ll sell physical, digital, or both types of products.
  2. Industry and product types: Select your industry (e.g., Fashion, Health & Beauty) and the main product types you plan to sell.
  3. Business details: Answer questions about how many products you plan to list and whether you’re setting up WooCommerce for a client.
  4. Theme: When asked about themes, keep your existing theme (such as Jannah). WooCommerce will automatically add store templates that match your current design as closely as possible.
Pro Tip: You can skip optional steps like marketing integrations during the initial wizard. Focus on core store and payment settings first, then come back to extras later.

Step 4: Configure General, Tax, and Shipping Settings

The setup wizard only covers the basics. Next, refine your store behavior from the main WooCommerce settings pages so taxes, shipping, and currency behave correctly.

4.1 General settings

  1. Go to WooCommerce > Settings > General.
  2. Confirm your Store Address and Selling locations (sell to all countries or specific ones).
  3. Set your default Currency, Currency position, and Thousand/Decimal separators to match your market.

4.2 Tax options (if applicable)

  1. Under WooCommerce > Settings > General, ensure “Enable taxes” is checked.
  2. Click the new Tax tab that appears.
  3. Choose how to calculate tax (based on store address, customer address, or shipping address).
  4. Create standard tax rates for each region where you must collect tax.
Warning: Tax rules vary widely by country and state. Check with a tax professional to confirm that your WooCommerce tax configuration matches current regulations.

4.3 Shipping zones

  1. Go to WooCommerce > Settings > Shipping.
  2. Create a Shipping zone for each region you ship to (e.g., “Domestic”, “Europe”, “International”).
  3. Within each zone, add shipping methods such as flat rate, free shipping, or local pickup.
  4. Configure costs and any minimum order values for free shipping.

Step 5: Set Up Payment Gateways

Without payments, your WooCommerce store is just a catalog. WooCommerce supports many gateways, including Stripe, PayPal, and region-specific providers.

  1. Go to WooCommerce > Settings > Payments.
  2. Toggle on the payment methods you want to offer (e.g., Cash on Delivery for testing, PayPal, or Stripe).
  3. Click Set up or Manage next to each gateway and enter API keys or account details provided by your payment processor.
  4. Where available, enable Test mode so you can run transactions without charging real cards.
Note: Always use sandbox/test credentials while you are configuring and testing payments. Switch to live keys only after you’ve verified that orders complete successfully.

For smoother checkout and better conversion rates, plan to optimize your store’s performance once everything works. When you’re ready, use these WooCommerce performance tips for faster stores to reduce friction at checkout.

Step 6: Add a Test Product and Place a Test Order

Before you invite real customers, verify that your catalog, cart, and checkout all work from a shopper’s point of view.

6.1 Add a test product

  1. Go to Products > Add New.
  2. Enter a product name (e.g., “Test Product – Do Not Buy”) and short description.
  3. In the Product data box, set the product type (Simple product is fine for testing) and add a regular price.
  4. If it’s a physical item, add weight and dimensions under the Shipping tab.
  5. Set a Product image and click Publish.
WooCommerce 'Add new product' page displaying details for a portable speaker with microphones, illustrating product setup.
A view of the WooCommerce ‘Add new product’ page, showing the entry form for a portable speaker, complete with description and image.

6.2 Place a test order

  1. Open your site in an incognito/private browser window.
  2. Find your test product (via shop page or direct URL), add it to the cart, and proceed to checkout.
  3. Fill in dummy billing/shipping details and complete checkout using a test payment method.
  4. Return to WooCommerce > Orders in your admin dashboard to confirm the order appears and its status (e.g., Processing or Completed).
Warning: When you finish testing, delete test products and disable test mode in your payment gateways. Leaving test settings live can block real payments or create confusing data.

Your WooCommerce Store Is Ready to Sell

By now, you’ve installed WooCommerce, run the setup wizard, configured your core settings, enabled payments, and successfully placed a test order. That means your WordPress site has officially evolved into a working online store.

From here, you can focus on adding real products, improving your product pages, and fine-tuning your design with the Jannah theme and Classic Editor. As traffic grows, don’t forget to monitor performance, security, and backups so your new store remains fast, stable, and profitable.

Further Reading

Frequently Asked Questions

Can I install WooCommerce on any WordPress site?

Yes, you can install WooCommerce on most self-hosted WordPress.org sites as long as your hosting meets the minimum PHP, MySQL, and memory requirements. It works with most well-coded themes, including Jannah, and can be used with either the Classic Editor or the block editor.

WooCommerce installation shows a critical error. What should I do?

A “critical error” during or after activation is usually caused by a conflict with another plugin, an outdated theme, or insufficient PHP memory. First, restore your latest backup if the site is down. Then, disable other plugins temporarily via the dashboard or FTP, switch to a default theme (like Twenty Twenty-Three), and try activating WooCommerce again. If the error disappears, re-enable plugins one by one to find the conflict.

My shop and product pages didn’t generate correctly. How can I fix this?

Sometimes the WooCommerce setup wizard fails to create all required pages. Go to WooCommerce > Status > Tools and use the tool labeled “Create default WooCommerce pages.” After that, visit Settings > Permalinks and click Save Changes to flush rewrite rules. This usually restores missing Shop, Cart, Checkout, and My Account pages.

What are best practices for choosing payment gateways in WooCommerce?

Choose payment gateways your customers already trust, such as Stripe or PayPal, and ensure they support your country, currency, and refund policy. Try to offer at least one real-time card processor plus a backup option like PayPal. Keep the number of gateways reasonable—too many choices can slow checkout and confuse buyers.

How long does it take to set up WooCommerce for a basic store?

If your WordPress site and hosting are already in good shape, a basic WooCommerce install with one or two payment gateways and a few products can be completed in 30–90 minutes. Plan extra time for design tweaks, testing, and writing high-quality product descriptions before you open your store to the public.

Andreas Weiss

Andreas Weiss is a 47-year-old WordPress specialist who has been working with WordPress since 2007. He has contributed to projects for companies like Google, Microsoft, PayPal and Automattic, created multiple WordPress plugins and custom solutions, and is recognized as an SEO expert focused on performance, clean code and sustainable organic growth.

Related Articles

Leave a Reply

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

Back to top button