> For the complete documentation index, see [llms.txt](https://docs.abtasty.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.abtasty.com/recommendations-and-merchandising/how-tos/how-to-configure-your-catalog-integration/how-to-configure-magento-integration.md).

# How to configure Magento integration

Connect your Magento store with AB Tasty Recommendations & Merchandising to deliver personalized product recommendations and advanced merchandising capabilities.

The Magento integration provides seamless synchronization of your catalog and categories, enabling real-time updates and intelligent automation — without requiring manual API calls or ID configurations.

***

### **Prerequisites**

Before integrating with Magento, ensure you have:

* An active **AB Tasty Recommendations & Merchandising** account
* Admin access to your **Magento store** with integration permissions
* The following Magento API credentials :
  * **Consumer Key**&#x20;
  * **Consumer Secret**&#x20;
  * **Access Token**&#x20;
  * **Access Token Secret**
  * **Store Code**&#x20;
  * **Store ID**&#x20;
  * **Currency**
* (Optional) Whitelisted AB Tasty IPs if your Magento environment uses bot protection
* Basic understanding of your product catalog structure (categories, variants, stock rules)

***

### **Access Magento integration**

Navigate to the integrations interface to connect your Magento store.

1. Log into your **AB Tasty Recommendations & Merchandising** dashboard
2. Click **SETTINGS** in the left sidebar navigation
3. Select the **Integrations** tab from the settings options
4. Locate **Magento** in the **CMS section** of the integrations page
5. The integration shows **Connected** status if already configured, or a **CONNECT** button if not yet set up

***

### **Set up Magento connection**

Establish a secure integration between your Magento store and the AB Tasty platform.

#### **Authorize AB Tasty access**

1. Click **CONNECT** next to the Magento integration (if not already connected)
2. Enter the Magento API credentials listed above
3. Review and validate the access rights requested by AB Tasty
4. Click **Save changes** to complete the connection

Once authorized, the integration automatically synchronizes your catalog via Magento web services.\
No manual API calls or strategy ID updates are required — saving changes in AB Tasty triggers automatic updates in your Magento environment.

***

### **Configure catalog synchronization**

Keep your product catalog continuously up to date in AB Tasty.

1. Catalog synchronization runs automatically at regular intervals (default: hourly)
2. Any new categories or collections added in Magento are automatically imported after each refresh
3. You can trigger a **manual refresh** from your AB Tasty dashboard if needed
4. Product data such as stock, price, and variant availability are retrieved from your Magento Admin API

{% hint style="info" %}
**Tip:** Ensure that your product hierarchy (parent/child products, bundles, variants) follows Magento’s best practices for optimal merchandising and recommendation performance.
{% endhint %}

***

### **Manage categories and collections**

AB Tasty automatically mirrors your Magento catalog hierarchy.\
This includes:

* Categories and subcategories
* Collections or product groupings
* Custom attributes defined in Magento (brand, tags, promotions, etc.)

Newly created categories in Magento appear automatically in AB Tasty after the next resource refresh, ensuring full alignment between your e-commerce backend and your recommendation setup.

***

### **Security and data management**

The Magento integration is built to ensure safe and compliant data exchange.

* All connections use **OAuth 1.0a** authentication via Magento’s API.
* API credentials are encrypted and securely stored within AB Tasty.
* Access is limited to catalog and merchandising data only — no sensitive customer data is collected.
* If your Magento instance includes a **bot protection system**, whitelist AB Tasty’s Cloud NAT IPs to allow synchronization requests:
  * `130.211.64.215`
  * `34.79.119.76`
  * `35.240.71.177`

***

### **Deploy recommendations on Magento**

Once the integration is complete, you can publish Recommendations & Merchandising strategies directly to your Magento storefront.

#### **Publishing updates**

* When you click **Save changes** in AB Tasty, all merchandising and recommendation updates are automatically pushed via the Magento webservice.
* No manual deployment or script editing is required.

#### **Widget and API deployment**

You can choose between:

* **Custom widgets** integrated directly into your Magento theme
* **Mix mode**, combining front-end widgets and server-side calls
* **Full API mode** for advanced setups or headless Magento implementations

***

### **Next steps**

Once your integration is complete:

* Proceed to Create your first web recommendation
* Or explore How to create a merchandising strategy
* For troubleshooting synchronization issues, visit Sync monitoring and logs

***

#### ✅ **In summary**

The Magento integration with AB Tasty is **native, automated, and secure**.\
It synchronizes your catalog and categories, manages updates automatically, and enables direct publishing of recommendations and merchandising strategies — all without technical complexity.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.abtasty.com/recommendations-and-merchandising/how-tos/how-to-configure-your-catalog-integration/how-to-configure-magento-integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
