Mailchimp Add-on Setup

Learn how to configure the Mailchimp Integration with eCommerce Support add-on in your store.

Olga Tereshina avatar
Written by Olga Tereshina
Updated over a week ago

After connecting your store to a Mailchimp account, you can configure the general settings of the Mailchimp Integration with eCommerce Support add-on in the Mailchimp settings tab.

The settings you need to configure are as follows:

  • Mailchimp API key: The API key used to connect your X-Cart store to your Mailchimp account. If, for some reason, you need to switch to a different Mailchimp account or update the API key, use the "Reset Mailchimp connection" link.

  • Enable E-commerce analytics: This option enables eCommerce analytics by Mailchimp for your X-Cart store. Check Mailchimp Knowledge Base for details.

    E-commerce analytics is the core component of the integration functionality; the setting is enabled by default, and we recommend keeping it that way. For E-commerce analytics-related features to function correctly, you will need to upload your store data (your store catalog and orders) to Mailchimp via the E-Commerce Features Setup tab of the add-on settings page. (This section appears on the page after you update Mailchimp lists). Be sure to visit the E-Commerce Features Setup page and specify the lists for which E-commerce Stores need to be created on the Mailchimp end. For detailed guidance, see Uploading Store Data to Mailchimp.

    Don't forget to enable E-commerce Link Tracking for your campaigns and automation in your Mailchimp admin.

  • Enable Abandoned Carts: This option enables the Abandoned Carts feature. For more info on this feature, see the Mailchimp site.

  • Default list for automatic campaigns: Specify the default list for automated campaigns. You will need it for the abandoned carts and order notifications features to function correctly for all your customers.

    If a list is not specified here, Mailchimp abandoned carts and order notifications will work only for current Mailchimp subscribers for this store.

  • Enable single opt-in for customers: This setting defines whether customers who opt in to subscribe to your news lists should be asked to confirm the subscription via email or not. When this option is disabled, new subscribers get an email with a subscription confirmation link that they need to click to be added to your list (Double opt-in). When this option is enabled, new subscribers are added to your list as soon as they opt in, not confirming the subscription by email (Single opt-in). Remember that abusing the single opt-in option may get your account banned by Mailchimp.

  • Subscription select element type (checkbox or select box): This setting defines how your customers select a subscription. If the select box option is enabled here, your customers can subscribe to only one mail list; if the checkbox option is enabled, your customers can select and subscribe to a single or multiple lists.

  • Update Mailchimp lists every (Never, 1 minute, 10 minutes, etc.): Select the time interval for the periodical list updates.

    For automatic periodical updates, ensure your server is configured to run scheduled tasks.

  • Type of discount coupons that should be uploaded to Mailchimp: Adjust this setting to specify the type of coupons that Mailchimp should be able to pull from your store to use in your campaigns via promo code content blocks.

    This setting is available only if the Coupons add-on is installed and active.

    The available options are:

    • All discount coupons: Select this option if you want to use any coupons created in your X-Cart store in Mailchimp.

    • Only the discount coupons that match the Mailchimp promo rules: Select this option if you need Mailchimp to be able to import only the coupons that have been configured with the following fields defined (all four of them, or just some of them):

      • Code;

      • Discount amount;

      • Active from;

      • Active till.

      Discount coupons configured using any fields on top of this set (for example, a coupon for which a product category or a product class has been specified) will not be imported into Mailchimp.

  • Site connection code: This is the field where your mc.js connection code snippet needs to be added.

    Once added via this field, the snippet is installed on your store website so that Mailchimp can insert javascript for features. Namely, mc.js is needed so your store website can display this block: In most cases, you will not have to manually add the mc.js code snippet via this field: the snippet will automatically appear in this field as soon as your store has been fully connected to Mailchimp. The connection process is considered fully completed after your store data has been uploaded to Mailchimp. After the completion of the connection process, you see your connected store in your Mailchimp account and can access the respective settings:


    By this point, the Site connection code field on the Mailchimp add-on settings page in your X-Cart store should already contain the mc.js code snippet you require. So all you need to do is to make sure it is there.

    Users upgrading from an older Mailchimp integration version without the "Site connection code" field to a newer version with this field, please read below!

    After the upgrade, the Mailchimp add-on settings page in your X-Cart store Admin area will have the new field, but the snippet will not be there as you have already completed the store connection process before the upgrade. To get the snippet in place, you will need to update your store data using the Update store data button in the E-Commerce Features Setup section. After that, the mc.js code snippet should automatically appear in the "Site connection code" field.

    An alternative method will be to manually add the code snippet in the "Site connection code" field. You can find the code snippet in your Mailchimp account via your connected store settings:


Click the Submit button at the bottom of the page to make the settings active.

After that, you need to update the Mailchimp lists by clicking the "Update Mailchimp Lists" button. That is required to make the E-Commerce Features Setup tab visible.

By clicking the "Update Mailchimp Lists" button, you will be automatically redirected to the Mailchimp Lists page (Marketing -> Mailchimp lists). Don't forget to return to the Mailchimp add-ons settings page to complete the configuration.

Related pages:

Did this answer your question?