Import Newsletters Subscribers

The VDCstore “Import Newsletter Subscribers Adobe App” is designed to simplify bulk migration of newsletter subscribers into an Adobe Commerce (Adobe Commerce Cloud ) store. The tool offers an intuitive CSV-based import process that validates email addresses, skips duplicates, and displays real-time per-row import results. This lets merchants move large subscriber lists into their stores quickly, reliably, and without manual data entry. Core Purpose & Value This extension’s primary function is to transform a CSV list of guest or external newsletter subscribers into a clean, Adobe Commerce Cloud-compatible newsletter list. It handles large datasets efficiently and ensures that only valid, unique email addresses are imported. By automating what would otherwise be a tedious and error-prone manual process, the app saves admins hours while preventing duplicate entries and maintaining a clean subscriber base. It also supports secure integration through Adobe Experience Cloud IMS (Identity Management System), ensuring that data is processed and transferred securely. Installation & Setup To get started, the extension requires Node.js (version 18 or newer) and the Adobe I/O CLI, which must be installed globally. The setup process involves creating an “App Builder” project in the Adobe Developer Console, enabling the “I/O Management API (OAuth Server-to-Server)” service, and then cloning the repository locally. After running npm install to install dependencies, the developer must download the environment configuration file from Adobe Developer Console and apply it using the aio app use command. Next, the .env file must be configured with: Adobe I/O runtime credentials (auth token, namespace, API host) The service API key Adobe Commerce (Adobe Commerce Cloud) store credentials — including base URL, consumer key, consumer secret, access token, and access token secret How It Works — Using the Import Tool Once installed and configured, administrators can access the Import Tool from the Adobe Experience Cloud dashboard under the “Newsletter Subscriber Import” section. The workflow is straightforward: Download Sample CSV (optional): A ready-to-use template is provided to ensure proper column structure for emails, status, and store code. Choose and upload the CSV file: On upload, the tool scans the file, counts records, and validates each email for correct format. Review the Subscriber Status Summary: Before executing import, the app displays how many addresses are already subscribed, how many are new, and how many are invalid or duplicates — giving full visibility into what will change. Import Subscribers: The tool imports only valid unique addresses, skips duplicates or invalid rows, and finalizes the import process. Verify results in Adobe Commerce Cloud Admin: After import, the full newsletter list — including existing and newly added subscribers — can be viewed under Marketing → Communications → Newsletter Subscribers. Data Safety, Validation & Error Handling The extension includes robust safeguards: It strictly requires CSV format uploads; other file types are rejected automatically to avoid security risks. Email addresses are validated for proper format. Invalid entries are flagged and not imported. Duplicate detection prevents multiple entries of the same email address, even across large lists. A preview summary ensures transparency before any changes are committed, enabling admins to fix errors if needed. Why It Stands Out vs Default Adobe Commerce Cloud Limitations By default, Adobe Commerce Cloud does not offer a bulk import mechanism for external newsletter subscriber lists. Without an extension like this, admin teams must add subscribers one-by-one.The VDCstore Import App solves this limitation entirely, enabling mass import/export while preserving subscription statuses (subscribed, unsubscribed, unconfirmed, not activated) and supporting multiple websites. Typical Use-Cases and Benefits Migration: When replatforming or upgrading a store — moving old subscriber lists into a new Adobe Commerce Cloud installation without losing data. Bulk onboarding: Importing large external email lists efficiently. List cleanup and consolidation: Validating emails, removing duplicates, and standardizing subscription status across multiple channels or store views. Maintenance and backups: Easily export and re-import subscriber lists for offline storage or integration with external marketing platforms.