PHPackages                             blueprint3d/module-etsy-integration - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. blueprint3d/module-etsy-integration

ActiveMagento2-module

blueprint3d/module-etsy-integration
===================================

Seamlessly sync your Magento catalog to Etsy with background queue processing.

v1.0.1(today)00proprietaryPHPPHP ~8.1.0||~8.2.0||~8.3.0

Since Aug 8Pushed todayCompare

[ Source](https://github.com/BluePrint3D-Dev/module-etsy-integration)[ Packagist](https://packagist.org/packages/blueprint3d/module-etsy-integration)[ RSS](/packages/blueprint3d-module-etsy-integration/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (3)Used By (0)

BluePrint3D - Etsy Integration for Magento 2 🛍️
===============================================

[](#blueprint3d---etsy-integration-for-magento-2-️)

 [![Magento Version](https://camo.githubusercontent.com/360e2de1fd9c704bed173bb02c7cd39ec1713f893d985460f9493be3e29b4e0f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6167656e746f2d322e342e782d6f72616e67652e737667)](#) [![PHP Version](https://camo.githubusercontent.com/8c00b402202c16d4eeeb48ffb3e4d80a4cf8bf01a9ac63b4e94b027dc76d5013/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532307c253230382e322532307c253230382e332d626c75652e737667)](#) [![Etsy API v3](https://camo.githubusercontent.com/6a9b723295838bec58ab0f6035470b7a7797c8997e68004039eaac67cb27b916/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f457473792532304150492d763325323052656164792d627269676874677265656e2e737667)](#) [![License](https://camo.githubusercontent.com/c5b41fe033f687a5997942b342a8e786ebc01b4de9e842f80506dbc103d386b6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d436f6d6d65726369616c5f45554c412d6c69676874677265792e737667)](#)

An enterprise-grade, direct-database Etsy v3 connector for Magento 2. Sync products, gallery images, smart tags, and dynamic personalizations to Etsy asynchronously in the background—without breaking cron schedules, causing Admin timeouts, or paying expensive monthly SaaS middleware fees.

---

🛑 The Problem
-------------

[](#-the-problem)

Most Magento 2 Etsy connectors rely on slow, synchronous HTTP requests during product save, causing Admin edit pages to crash or lock up. Worse still, existing tools treat custom options as broken variants, forcing merchants to build complex configurable products just to collect simple buyer text inputs or engraving choices.

🛠️ The Solution
---------------

[](#️-the-solution)

The **BluePrint3D Etsy Integration** handles your catalogue sync using a lightweight, direct-database background queue worker. Built natively for the latest **Etsy API v3**, it automatically converts both native Magento Custom Options and [BluePrint3D Shared Options](https://github.com/BluePrint3D-Dev/module-shared-product-options) into native Etsy Personalizations and custom dropdowns without risking catalogue corruption or inventory miscounts.

✨ Features
----------

[](#-features)

- **Asynchronous Background Queue:** Offloads heavy API lifting to a dedicated DB queue table (`blueprint3d_etsy_queue`) and cron worker. Product saves in Admin remain instant.
- **Native Etsy Personalization Sync:** Leverages Etsy's multi-question personalization API to automatically push text fields, text areas, and non-inventory dropdowns straight into Etsy's custom options box.
- **BluePrint3D Shared Options Ready:** Zero-config compatibility with `BluePrint3D_SharedProductOptions`, bypassing Admin/CLI area restrictions to read shared groups seamlessly.
- **Smart Tag Generator:** Extracts meta keywords, cleans forbidden characters, caps length at 20 characters, and automatically falls back to product titles if meta tags are missing.
- **Automated Gallery Sync:** Sorts and uploads up to 10 high-resolution product gallery images according to native Magento position rankings.
- **Configurable Safeguards:** Built-in *Strict Mode* (abort sync and alert admin) and *Lenient Mode* (strip unsupported options and log warnings) to protect listings from API rejection.

---

📦 Installation
--------------

[](#-installation)

**1. Register the Private Packagist Repository**

```
composer config repositories.blueprint3d composer https://repo.blueprint3d.dev
```

**2. Install via Composer**

```
composer require blueprint3d/module-etsy-integration
```

**3. Enable the module**

```
php bin/magento module:enable BluePrint3D_EtsyIntegration
```

**4. Run the database upgrade**

```
php bin/magento setup:upgrade
```

**5. Compile and flush cache**

```
php bin/magento setup:di:compile
php bin/magento cache:flush
```

---

⚙️ Quick Configuration
----------------------

[](#️-quick-configuration)

1. Navigate to **Stores > Configuration > BluePrint3D > Etsy Settings** in your Magento Admin.
2. Enter your **Etsy OAuth API Credentials** and **Shop ID**.
3. Configure your **Unsupported Options Handling** (*Strict Mode* or *Lenient Mode*).
4. Map your Magento Categories to **Etsy Taxonomy IDs** under **Catalog > Categories**.
5. Save any assigned product to queue it for immediate background sync!

---

📜 License & Support
-----------------------

[](#-license--support)

**Copyright © 2026 BluePrint3D Ltd. All rights reserved.**

This software is licensed under a Commercial Proprietary End User License Agreement (EULA). Resale, redistribution, sublicensing, or public hosting of this source code is strictly prohibited.

For licensing updates, technical documentation, or dedicated integration support:

 **Website:** [www.blueprint3d.dev](https://www.blueprint3d.dev)
 **Company:** BluePrint3D Ltd (Company Registration Number: 13473806)
 **Support Email:**

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

0d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f2274c6709b456f938e47fb40f3c9be3c443c0532e7e4b794e67d5864309e6c4?d=identicon)[stu583](/maintainers/stu583)

### Embed Badge

![Health badge](/badges/blueprint3d-module-etsy-integration/health.svg)

```
[![Health](https://phpackages.com/badges/blueprint3d-module-etsy-integration/health.svg)](https://phpackages.com/packages/blueprint3d-module-etsy-integration)
```

###  Alternatives

[fastly/magento2

Fastly CDN Module for Magento 2.4.x

1564.5M1](/packages/fastly-magento2)[mollie/magento2

Mollie Payment Module for Magento 2

1142.0M17](/packages/mollie-magento2)[nosto/module-nostotagging

Increase your conversion rate and average order value by delivering your customers personalized product recommendations throughout their shopping journey.

27714.5k4](/packages/nosto-module-nostotagging)[checkoutcom/magento2

Checkout.com Payment Gateway for Magento 2

34280.5k3](/packages/checkoutcom-magento2)[myparcelnl/magento

A Magento 2 module that creates MyParcel labels

1861.2k](/packages/myparcelnl-magento)[doofinder/doofinder-magento2

Doofinder module for Magento 2

12256.9k1](/packages/doofinder-doofinder-magento2)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)