Skip to main content
All CollectionsIntegrationsMagento Open Source and Adobe CommerceSetup
Install the Dotdigital Marketing Automation extension for Magento Open Source and Adobe Commerce
Install the Dotdigital Marketing Automation extension for Magento Open Source and Adobe Commerce

Learn how to install the Dotdigital Marketing Automation extension using Composer.

Gareth Burroughes avatar
Written by Gareth Burroughes
Updated over a year ago

The Dotdigital Marketing Automation extension must be installed before you can connect your Dotdigital account to your Adobe Commerce (previously Magento 2) store. The extension can be found on Adobe Commerce’s extensions marketplace and can be installed through Composer's dependency management tool.

This article includes guidelines for a pre-installation health check to ensure all goes as well as possible before, during and after installation, and the necessary links for your developers to follow for the installation.


Before you start

Things you need to know:

  • Our Adobe Commerce integration has an initial onboarding charge for setup assistance, and a monthly license fee to ensure ongoing support and development. To learn more, speak to your Customer Success Manager.

  • The connector installation should be done by your developers.

  • Our latest code runs on Magento Open Source and Adobe Commerce (version 2.3 upwards). Compatibility will change over time. To check the latest requirements please check Github:

  • We recommend that you back up your installation before using it.


Pre-installation health check

File permissions on var/export

File permissions on your site are an important part of the connector being able to write imports to be sent to Dotdigital.

The connector will require full access (0777) to the var/export directory or full access to the CRON user running on the server.

UAT and sandbox environments

Dotdigital always recommends testing any new code within sandbox and UAT environments, enabling you to check the compatibility with your site and other extensions you may have installed.

For UAT and sandbox environments, you should check the types of your contact data fields in Dotdigital plus any possible firewall restrictions for API calls, for example, when connecting an API user between Dotdigital and Adobe Commerce.

Cron heartbeat

The cron heartbeat should be running every minute to do the required tasks and the synchronisation of data into the Dotdigital account. The connector is unable to function correctly without cron tasks.


Connector installation

To install the Dotdigital Marketing Automation extension:

  1. You must purchase the core extension from the Adobe Commerce extensions marketplace. The account used for this should be the same one from which you create access keys for your Adobe Commerce instance.

  2. Use Composer to require the metapackage (from repo.magento.com):

  3. composer require dotdigital/dotdigital-magento2-os-package

  4. If you require them, install additional modules (from packagist.org):

  5. composer require dotdigital/dotdigital-magento2-extension-enterprise

  6. composer require dotdigital/dotdigital-magento2-extension-b2b

  7. Upgrade Adobe Commerce and re-compile code:

  8. bin/magento setup:upgrade

  9. bin/magento setup:di:compile

Databases and cron services

The Dotdigital Marketing Automation extension has several cron tasks attached to the installation to ensure the connector functions correctly.

Did this answer your question?