nopCommerce is an open-source ecommerce platform that lets you build and manage an online store. This guide walks you through installing the Omnisend plugin for nopCommerce, connecting your store, and running the initial data sync.
Note: If you don't have an Omnisend account yet, create one first. Read the guide: Creating an Omnisend Account.
Before You Begin
Make sure you have admin access to both your nopCommerce store and your Omnisend account.
The Omnisend plugin for nopCommerce is developed and maintained by the nopCommerce team, not Omnisend. For plugin bugs or installation errors, contact nopCommerce support or check their community forum.
Setup Process
Step 1: Download the Omnisend Plugin
In your nopCommerce admin, go to Configuration → All plugins and themes.
2. Find Omnisend in the list, or go directly to the Omnisend Plugin page and click Get Extension.
3. A plugin archive file downloads to your computer. Note where it is saved.
Step 2: Upload and Install the Plugin
In your nopCommerce admin, go to Local plugins → Upload plugin or theme.
2. Select the Omnisend plugin archive you downloaded and click Upload plugin or theme.
3. Click Restart application to apply changes.
4. After the application restarts, find Omnisend in the plugins list and click Install.
5. Restart the application again.
6. Click Configure to open the Omnisend plugin settings page. Keep this tab open.
You'll be redirected to this page. Don't close this page just yet.
Step 3: Generate Your API Key in Omnisend
In a new browser tab, open your Omnisend account and click Connect your store on the Dashboard.
2. Select nopCommerce from the list of platforms.
3. Omnisend generates an API key automatically. Copy it.
Note: The API key is generated automatically at this step. You do not need to create a key manually in Store Settings.
Step 4: Save the API Key in nopCommerce
Go back to your nopCommerce tab with the Omnisend plugin Configure page.
Paste the API key into the API key field and click Save.
Step 5: Run the Initial Sync
After saving, click Sync contacts and Sync products to import your existing data into Omnisend.
2. The sync status shows how many contacts, products, and categories were imported. Sync time depends on the size of your store.
Step 6: Verify the Connection
1. In your Omnisend account, click Check API Connection to confirm the integration is active.
2. You will be prompted to add your Brand Assets. After completing this, you land on the Dashboard – the integration is now active.
Supported Features
Email and SMS campaigns.
These Automation workflows: Order Confirmation (Paid for Order and Placed order events), Cancellation Confirmation (Order Canceled event), Birthday, Welcome email, Contact enters/exits segment, Browse Abandonment, Product Abandonment, Abandoned Checkout & Abandoned Cart.
Segmentation. Most of the filters in the segmentation are available, except the order statuses events: Paid for order, Canceled order, Had order shipped, Had partially shipped order, Refunded order, Had partially refunded order. However, you can still utilize the 'Placed order' filter.
Note: Order event automations – such as Order Confirmation – can be delivered to contacts regardless of their marketing subscription status. In the email step of your automation, set the channel to Any Subscription Status (Transactional Messages) to ensure order-triggered emails reach all buyers, including those who are not subscribed to marketing.
What Data Is Passed
Contacts
All contacts in your nopCommerce Newsletter subscribers list are synced to Omnisend. For the initial sync of historical contacts, run Sync contacts as described in Step 5.
Note: Contacts passed from nopCommerce trigger the Welcome automation. So, you can set up a single Welcome automation for both contacts collected via the nopCommerce and Omnisend Signup forms.
Orders
All new orders your customers place will be synced to Omnisend immediately. The following order events are sent to Omnisend:
Placed order
Paid for the order
Order Cancelled
Order refunded
Order fulfilled
Note: Historical order data will not be synced.
Products
After the initial sync (Step 5), all products from your nopCommerce admin sync to Omnisend. New products and updates to existing ones sync automatically after the integration is active.
Product sync lets you use the Product Picker in the Product Listing block to build email content faster.
Carts
If the nopCommerce system has the email address associated with a cart, all cart data is passed to Omnisend. This enables the Abandoned Cart workflow with the Added Product to Cart trigger.
Troubleshooting
I clicked Sync contacts but no contacts appeared in Omnisend →
Only contacts in your nopCommerce Newsletter subscribers list sync. Buyers who did not opt in to the newsletter will not appear. Check that your contacts are in that list, then run the sync again.
I'm getting an error when I click Sync contacts →
This is a plugin-level issue. The Omnisend plugin for nopCommerce is developed and maintained by the nopCommerce team. If you are on plugin version v4.90.x, a known sync bug has been documented on the nopCommerce community forum. Contact the nopCommerce support team directly for a fix or updated plugin version.
Phone numbers are missing after sync →
In some plugin versions, phone number data does not transfer during contact sync. Check whether a newer version of the Omnisend plugin is available on the nopCommerce marketplace and update if so. If the issue persists, contact the nopCommerce support team.
Omnisend shows the store as connected, but contacts or orders are not appearing →
A successful API connection means the key was accepted – it does not confirm that data is syncing. Check the following:
Confirm you clicked both Sync contacts and Sync products after saving the API key.
In Omnisend, go to Store Settings → API keys → API Access Logs to check whether requests from your store are reaching Omnisend.
If no requests appear, restart the nopCommerce application and re-save the API key on the plugin Configure page.
FAQ
Where do I find the API key to enter in nopCommerce?
You do not create the key manually. In Omnisend, click Connect your store, select nopCommerce, and Omnisend generates an API key automatically. Copy that key and paste it into the API key field on the plugin Configure page in nopCommerce.
Can I send order confirmation emails to contacts who didn't subscribe to my newsletter?
Yes. Order events sync to Omnisend for all contacts, regardless of newsletter subscription status. In the email step of your Order Confirmation automation, set the channel to Any Subscription Status (Transactional Messages) to reach all buyers.
Will historical orders sync after I connect?
No. Only orders placed after the integration is active sync to Omnisend. Historical order data is not supported.
The plugin is showing an error. Who do I contact?
The Omnisend plugin for nopCommerce is built and maintained by the nopCommerce team. For plugin bugs, contact nopCommerce support or check their community forum for known issues and updates.
Need further guidance? Our support team is just a click away in the app, or you can email [email protected].