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

# Magento 2 Customer Attribute Subscriber

> Configuration-based replacement for the prototype customer-attribute-subscriber in the Legacy Magento 2 Connector.

## Overview

The **Customer Attribute Subscriber** is a configuration-based subscriber that listens for customer attribute data from a Magento 2 source system. It replaces the deprecated prototype-based `magento-2-customer-attribute-subscriber` previously used in the Legacy Magento 2 Connector.

> [!NOTE]
>
> This component has been migrated from a prototype-based implementation to a configuration-based setup as part of the Legacy Magento 2 Connector replacement project.

## Prototype vs Configuration-based

> [!WARNING]
>
> This is an important behavioral difference to understand before setting up this component.

| | Prototype-based | Configuration-based |
| - | - | - |
| **Reusability** | Can be reused across different flows by changing a few fields | Not reusable across different purposes or payloads |
| **Flexibility** | One prototype can serve multiple use cases | (Not always) Each use case requires its own dedicated configuration |
| **How to reuse** | Modify fields directly | Duplicate the configuration and adjust as needed |

If you need to handle a different payload structure or use case, you must **duplicate** this Subscriber and adjust the configuration accordingly. Do not modify an existing configuration as another Route already uses it.

## Type

**Subscriber**

## Purpose

This Subscriber listens to incoming customer attribute data from Magento 2 and triggers the appropriate Route for further processing. It is used in flows where customer data or custom attributes need to be synced or mapped to a target system.

## Configuration

| Parameter | Description | Required |
| - | - | - |
| `store_code` | The Magento 2 Store Code | Yes |
| `http-client` | The HTTP Client Authentication method used to connect to Magento 2 | Yes |
| `entity-schema` | The specific schema for the entity | No |

## Usage

1. Navigate to **Subscribers** in your Alumio environment.
2. Search for **Magento 2 Customer Attribute Subscriber**.
3. Configure the required parameters as described above.
4. Attach this Subscriber to the relevant route as the Incoming configuration.

## Deprecated VS New

An example of the deprecated configuration:

![Image](https://mintcdn.com/alumio/i_0oO_KC23VzYTWk/images/image-379-legacy-m2.png?fit=max\&auto=format\&n=i_0oO_KC23VzYTWk\&q=85\&s=dd5157b6f68c17777613d3ff55ac22b3)

An example of the new configuration:

![Image](https://mintcdn.com/alumio/i_0oO_KC23VzYTWk/images/image-380-legacy-m2.png?fit=max\&auto=format\&n=i_0oO_KC23VzYTWk\&q=85\&s=a99126e7c4a7cc44c62742912ed0774b)

## Related Components

* [Magento 2 Customer Attributes Subscriber (Transformer - Mapping) (Transformer)](magento-2-customer-attribute-subscriber-v2-transformer) - to restructure the result.

## Notes

* Replaces the prototype: `magento-2-customer-attribute-subscriber`
* Unlike the prototype-based implementation, this configuration-based subscriber is **not reusable across different purposes or payloads**. If you need to handle a different payload structure or use case, you must duplicate this Subscriber and adjust the configuration accordingly.
* Commonly used in customer attribute data sync flows between Magento 2 and ERP or CRM systems.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.