> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.weltpixel.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to install extension if purchased from Magento Marketplace

# Installing via Composer CLI Commands

Composer CLI is the **only supported method** to install Magento 2 modules, as Magento has deprecated the Web Setup Wizard.

---

## Step 1 — Check Compatibility
Before installing, verify that the extension is compatible with your Magento version.  
WeltPixel Marketplace extensions are compatible with **Magento 2.3.X – 2.4.X**.  

> Always install on a **development/staging server first**, then move to production after verifying functionality.

---

## Step 2 — Configure Authentication Keys
Ensure your **Magento Marketplace Authentication Keys** are configured on your instance.  

If keys are missing or misconfigured, Composer may return a  
**“no matching package found”** error.  

Refer to [Magento Documentation](https://devdocs.magento.com/guides/v2.4/install-gde/prereq/connect-auth.html) for instructions on generating and adding these keys.

---

## Step 3 — Install the Extension
Navigate to the root of your Magento project and run the following commands.  
For example, to install the **Layered Navigation** extension:

    composer require weltpixel/m2-weltpixel-layered-navigation
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento setup:static-content:deploy -f

---

# Installing Manually via SSH (legacy, before 1.16.0)

Manual installation is no longer offered for paid products. Since 1.16.0, paid WeltPixel extensions and themes install and update via Composer only.

If you purchased directly from [weltpixel.com](https://www.weltpixel.com/), or migrated your Marketplace purchase to your WeltPixel account, get Composer access under **My Products** at [account.weltpixel.com](https://account.weltpixel.com).

If you’ve purchased from the Marketplace and would like to migrate, see this guide:  
[Manual (SSH) Installation if product is purchased from Magento Marketplace](https://help.weltpixel.com/en/article/manual-ssh-installation-if-product-is-purchased-from-magento-marketplace-fu0zvy/?bust=1758026309384)

---

# License Key for Paid Extensions

Paid extensions purchased via the Marketplace require a **WeltPixel License Key**.  
To generate your license key, see this guide:  
[How to generate a license key and access the latest version of a WeltPixel product if purchased via the Magento Marketplace](https://support.weltpixel.com/hc/en-us/articles/115004378627-How-to-generate-a-license-key-and-access-the-latest-version-of-a-WeltPixel-product-if-purchased-via-the-Magento-Marketplace)

---

# Deprecated Method

Magento has removed the **Web Setup Wizard**, but for reference, the legacy installation method is documented below.  

After purchase, you would be redirected to the Marketplace order confirmation page:

1. Click **Install** on the confirmation page.  

   ![Magento Marketplace success page after purchase](https://storage.crisp.chat/users/helpdesk/website/-/a/e/3/c/ae3c2331b6a5f000/e9f9d78b-9c66-4001-bcbe-a9bb66_dem3b0.png)

2. Create and use **Access Keys**.  

   ![Magento Access Keys settings](https://storage.crisp.chat/users/helpdesk/website/-/1/6/2/a/162afff9ae1cfd00/3c5508b2-d2bf-49a0-8c40-a3bb66_18u40m2.png)

3. Go to **System → Web Setup Wizard** in your Admin Panel.  

   ![Magento Web Setup Wizard in admin panel](https://storage.crisp.chat/users/helpdesk/website/-/5/d/8/4/5d843c10f8103400/322e94fd-1068-4f1b-ac4c-fa1ebb_1seaumw.png)

4. In **Extension Manager**, sign in with your keys.  

   ![Magento Extension Manager authentication screen](https://storage.crisp.chat/users/helpdesk/website/-/d/c/b/f/dcbf8289d2e2e000/0f64de97-c851-4230-8c23-c763a6_x7xqsm.png)

5. Click **Refresh** to sync Marketplace purchases, then review and install.  

   ![Magento Extension Manager available extensions](https://storage.crisp.chat/users/helpdesk/website/-/9/e/2/4/9e247682cc121800/0fff14f6-ecf4-4e04-9ab0-b42e6d_1qg3js3.png)

6. Select the module and click **Install**.  

   ![Magento Extension Manager module installation step](https://storage.crisp.chat/users/helpdesk/website/-/6/f/d/a/6fdafdb702fda400/a5c4475e-b5b2-478c-a0e4-0f53c7_14biyy5.png)

7. Proceed through readiness checks. Create a **backup** before continuing.  

   ![Magento Web Setup Wizard readiness check](https://storage.crisp.chat/users/helpdesk/website/-/9/f/6/2/9f6222d963cbb000/b59e0929-e903-495e-8a0c-8942fb_161c3n5.png)  
   ![Magento Web Setup Wizard readiness check results](https://support.weltpixel.com/hc/article_attachments/360001120173/readiness2.png)  
   ![Magento Web Setup Wizard backup creation step](https://support.weltpixel.com/hc/article_attachments/360001120273/backup.png)  
   ![Magento Web Setup Wizard installation progress](https://support.weltpixel.com/hc/article_attachments/360001136674/install2.png)

8. Wait for the process to complete and the **Success** page to appear.  

   ![Magento extension installation success message](https://support.weltpixel.com/hc/article_attachments/360001120933/success.png)

9. The extension is now installed. Proceed with the configuration steps from the extension’s documentation.

---

# Installation Troubleshooting

If you encounter issues, review these troubleshooting guides:

- [Autoload error — How to fix Magento Marketplace wizard installation error](https://help.weltpixel.com/en/article/autoload-error-how-to-fix-magento-marketplace-wizard-installation-error-mobm54/?bust=1758026448577)  
- [How to fix autoload error — Manual installation vs Magento composer installation](https://help.weltpixel.com/en/article/how-to-fix-autoload-error-manual-installation-vs-magento-composer-installation-c8q3tv/?bust=1758026474593)