> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runconverge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce Web

> Install the WooCommerce Storefront Plugin

export const DownloadLink = ({linkText, linkTarget}) => {
  return <a target="_blank" href={linkTarget} download> {linkText} 
    <div className="inline h-3 w-3 fill-gray-500 dark:fill-gray-100 text-gray-500 dark:text-gray-300 ml-1 mr-1">
      <svg className="inline w-3 h-3 bg-gray-500 dark:bg-gray-300 -mt-1" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/download.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }}></svg> 
    </div>
    </a>;
};

The WooCommerce Website Integration consists of a WooCommerce plugin that tracks your storefront and checkout events.

***

## Installation instructions

The Converge Website installation for a WooCommerce store consists of:

<Steps>
  <Step title="Create a new Client Source in Converge">
    1. In Converge, click on **Create a new source**
    2. Pick *Client-side* from the modal
    3. Name your pixel: e.g. `{Storename} Storefront`
  </Step>

  <Step title="Install the WooCommerce Plugin">
    4. Download the WooCommerce Plugin by clicking on the following link: <DownloadLink linkTarget="https://static.runconverge.com/converge_woocommerce.zip" linkText="Download Plugin" />

    5. In the WordPress admin dashboard, navigate to **Plugins** in the sidebar and click on **Upload Plugin**.

    6. Choose the .zip file that you just downloaded as the file to upload.

    7. Click on **Install Plugin** and after that on **Activate Plugin**
  </Step>

  <Step title="Configure the WooCommerce Plugin">
    8. In the Converge web app, click on the source you created in *Step 1* and copy the **Public Token**.
       <Info> The code consists of 6 characters and can be retrieved from the HTML snippet. If your script `src` looks like `https://static.runconverge.com/pixels/AYU51m.js`, then your public token is `AYU51m`. </Info>
    9. Navigate to **Tools** > **Converge** in the WooCommerce dashboard.
    10. Fill in the **Public Token** and save the configuration.
  </Step>

  <Step title="Verify that the integration is working correctly">
    11. Check that the plugin is working correctly by generating some `$page_load`, `Added To Cart`, `Started Checkout` events by visiting the store and seeing that these events arrive in the Source Log.

    <Info>Set up a [Pixel Monitor](/sources/monitoring#pixel-monitor) to automatically verify your pixel stays installed.</Info>
  </Step>
</Steps>

***

## Event spec

This integration auto-tracks the following events on the browser with all properties available according to the [Converge event spec](/sources/converge-spec).

| Event Name                                                  | Event Description                               | Integration |
| ----------------------------------------------------------- | ----------------------------------------------- | ----------- |
| [PageView](/sources/converge-spec#page-view)                | When a customer views a page.                   | Storefront  |
| [Viewed Product](/sources/converge-spec#viewed-product)     | When a customer views a product.                | Storefront  |
| [Added To Cart](/sources/converge-spec#added-to-cart)       | When a customer adds an item to cart            | Checkout    |
| [Started Checkout](/sources/converge-spec#started-checkout) | When a customer initiates the checkout process. | Checkout    |
| [Placed Order](/sources/converge-spec#placed-order)         | When a customer places an order.                | Checkout    |