Using the Monarch Retail Sync Extension

by Lara

Last Updated May 16, 2025 16:22

The Monarch Extension will help you get a clearer picture of your Amazon shopping orders by sorting items purchased online into more detailed categories—no more seeing all of your purchases fall into one big “Shopping” category.

The extension works by syncing your Amazon order details, then analyzing each item to determine the best category for each purchase. The extension will automatically split and categorize these transactions within Monarch to give you a more accurate view of your spending, and will even add notes to the transaction so you know exactly what was in that order and why it was categorized that way.

Downloading and Using the Extension

Download the extension from the Chrome Web Store using your desktop browser.
Open the extension (you may need to click into the puzzle icon in your browser to select it from your list of extensions) and click “Log in to Monarch.” If you’re already logged in on this browser, you won’t have to enter your credentials again.
You’ll see confirmation that Monarch is connected.
Next, log in to Amazon in a new tab on the same browser. Once logged into Amazon, click “Set up” within the extension. Note: the extension will only sync from the Amazon account you’re signed into, and works with Amazon US with the language set to "English." It will not sync with Amazon Business accounts.
From here, you’ll choose what actions you would like the extension to take, and whether you want these actions to apply to the past three months of transactions or only to future transactions. Once selected, click “Connect Amazon.”
• If you opt to "Apply to past and future transactions," the following will occur:
- If you select “Add item details to transaction notes,” the process will add notes, but will not overwrite existing notes.
- If you select “Automatically split and categorize,” it will override any existing splits or categorization that you may have already done either manually or via rules.
• If you opt to apply to “Only future transactions,” you will still click “Connect,” and your preferences will save. The extension will verify that it can pull order data from Amazon by pulling in the last three months of orders, but the sync will not make any changes to these orders. You can later go back and use the "Sync older orders" option to fill in history if you choose.
Once connected, you’ll see “Sync now.” Click this to run the sync for the first time. You can navigate away from this page and the sync will continue to run in the background.
When the sync has run, you will see a summary of the actions taken.
You can click the “settings” gear icon within the extension at any time to view your synced orders, update the settings, get help, or import older orders.
If you would like the sync to run automatically every 24 hours as long as you’re signed into Monarch and Amazon, you can turn on the “Auto-sync” option by clicking the extension icon again. You can also run a manual sync at any time by clicking “Sync now.”
Note: If you log out of Monarch, you will also be logged out of the extension and will need to log in again.

What Happens When You Sync

Monarch attempts to match Amazon purchases to transactions within Monarch based on merchant, amount, and approximate date. For your initial sync, if you allow it to modify past and future transactions, this will occur for the last three months’ worth of orders, but you can also sync older transactions within the extension settings.
If you opted to allow the extension to add notes, the sync will amend notes but not override existing notes for the time period selected.
If you opted to allow the extension to split and re-categorize, it will override any manual splits or categorization for the time period selected. If a matched transaction was split manually or via a rule previously, the sync may un-split it and create new splits.
When splitting and re-categorizing is allowed, the extension analyzes order details to determine the correct category for each of the items within the order--yes, even using your custom categories! If there is a better category for any part of the order, it will split the order into multiple transactions within Monarch, with each transaction being sorted into the new category. If there’s only one item in the order, then that one transaction will be updated to the new category. When a better match can't be found, all or part of the order may remain under the “Shopping” category.
Taxes are distributed proportionally based on the split amount, and delivery fees and other fees are split evenly across all items.
A system tag (Retail Sync) is applied automatically to help you filter these transactions.
Any unmatched transactions will remain as-is and not be updated. This most often occurs when the extension pulls an order but can’t find the matching transaction in Monarch due to the payment method not being connected in Monarch, or the transaction has not hit Monarch yet. The extension will try to match them again during the next run.
Note: Orders that were entirely paid for by credit (i.e. gift cards) or other payment methods not linked to Monarch will not be matched, nor will pending transactions.

Syncing Older Orders

If you opted to have the initial import run on past & future orders, the extension will pull Amazon orders from the last three months. If you want to have the extension run on orders older than that (back to 2018), you can do so by visiting the extension settings and clicking on “Orders.” From here, you can choose to sync orders from a previous year by selecting the desired year and clicking “Sync.” You can navigate away from this page while it is running.

The past sync will respect the settings that you have selected within the extension with regards to whether it adds notes, recategorizes, or both, and will overwrite category updates or splits that were previously made.

When you run the sync on past orders, it will update past orders regardless of whether or not you selected sync ”Only future transactions” upon initial setup.

This process is limited to one past sync per hour due to retailer rate limits.

💡 Note: If your past order sync fails, please try logging out of Amazon in your browser and logging back in, then reconnecting the extension to Amazon. If the sync continues to fail, it may be because there are too many orders that year, and Amazon is rate-limiting the extension. In general, if this is the case, the sync will not complete. At this time, you can sync up to 180 orders per year using the backfill option.

Viewing Synced Transactions

You can open the settings in the extension by clicking on the gear icon from the extension box, and then click “Orders” to view all imported Amazon transactions and how they were split and categorized by the extension.
Within the Monarch app, you can filter your transactions using the “Retail Sync” tag to quickly view all purchases that were updated using the extension, or use the tag to create custom reports.

Extension Settings

You can visit the extension settings at any time by clicking the the gear icon within the extension.
The settings you select during the set-up process will be retained for future syncs unless you manually update them.
Any changes made to settings (like choosing to only add notes to transactions during the sync) will apply to future syncs, and will not update transactions that were already imported.
Once a transaction is touched by the extension, it won’t be updated again, even if you later change the settings.

Troubleshooting

Sync failed
- Note that the extension currently only works with Amazon US, and only on Amazon personal accounts (not business accounts). In order for the sync to work, the Amazon language must be set to English.
- Try refreshing the browser or re-opening the extension.
- Make sure you're logged into both Monarch and Amazon in the same browser on different tabs.
- If you are already logged in, try logging out and logging back into both sites (you’ll need to reconnect in the extension as well).
- If problems persist, remove and reinstall the extension. Previously updated transactions will not be affected.
- If you are using the "Sync older orders" option, you may need to sign out of Amazon and sign back in again. However, if the sync continues to fail, the sync is likely being rate-limited by Amazon due to too many orders. At this time, we can only sync up to 180 orders per year for this reason.
Transactions not matched
- The transaction will attempt to match based on date, order amount, and merchant. If any transactions were unmatched, the extension will continue to try to match them each time it runs.
- Some orders in Amazon may come through to Monarch with the merchant listed as something else, such as “Amazon Groce” or “Amazon Tips.” You may manually update these to show the merchant as “Amazon” (or use a rule to do this automatically), and the sync should be able to match them next time it runs.
- Confirm that the financial account used for the purchase is linked within Monarch. We may not be able to match all transactions made with credits, gift cards, or other methods of payment.
- In the extension settings, you can click on "Orders" and then an Amazon order ID number to be taken to the order details page. From there, scroll to the bottom of the order information and look for the "Credit Card Transactions" line as shown in the screenshot below:
  
  You can use this information to verify that the payment method is matched within Monarch. If this line is missing entirely, the transaction will not be matched.
- Pending transactions will not be matched.
- If an Amazon order matches multiple transactions in Monarch (based on date of charge and charge amount), it will only match to the older of the two transactions. At this time, we do not consider the account name when matching transactions.
- If, upon initial setup, you selected to only run the sync on future orders, past orders will not be synced.
- Monarch or Amazon may not be fully connected. Try using the steps above to troubleshoot “Monarch or Amazon not connected.”
Monarch and/or Amazon are disconnected
- Make sure you're logged into both Monarch and Amazon in the same browser on different tabs.
- If you are already logged in, try logging out and logging back into both sites (you’ll need to reconnect in the extension as well).

FAQS

What retailers does the extension support?

Right now, the extension is only available for Amazon US orders, though we plan to add support for Amazon Canada in the near future. We also are exploring adding support for additional retailers (be sure to vote for your choice on the “Your Retailers” page of the extension settings!).

What are the browser + device requirements?

At this time, the extension works on Chrome and Chromium-based browsers (Microsoft Edge, Brave, Opera, Vivaldi, Kiwi). Desktop use is required. Currently, the extension won’t work on mobile. We are exploring adding additional browser support in the future.

What type of orders will the extension process?

Currently, the extension will attempt to match Amazon US retail orders that were paid for using a payment method linked to Monarch. At this time, Kindle books or other digital orders, Whole Foods orders, Amazon Fresh, digital subscriptions, and non-US Amazon orders are not included.

Refunds cannot be matched right now, but we are looking at supporting these in the future.

Orders made via the Amazon mobile app will sync, but you will still need to log into Amazon on a desktop in order for the extension to work.

Can I undo changes made by the extension?

While you can't bulk reverse the changes made by the extension, you can use the "Retail Sync" tag to view all of the transactions affected and make any changes manually. You can set up rules to help with this if needed.

What if I have a household with multiple Amazon accounts?

While by default only one Amazon account can be used at a time with the extension, you can sync multiple Amazon accounts by switching the logged-in Amazon account. Future syncs will use the most recently logged-in account. You will still see past orders from the previous account under "Orders." This process allows users to sync data from multiple accounts.

The extension can also be installed on multiple devices or different Chromium browsers, with a different Amazon account logged into each one.

What if I share an Amazon account with others not in my Monarch household?

All orders under the Amazon account will be visible under the "Orders" section of the extension settings, however, the extension will only be able to match orders that are listed as a transaction within your Monarch account. It will not create new transactions within Monarch for the other orders.

What happens if my order was originally split by Amazon into multiple payments?

For orders that were split by Amazon into multiple charges, the Monarch extension will still attempt to match them to transactions within Monarch.

Will the extension be able to match transactions if I paid with a gift card, credit, or other alternative payment method?

If the order was fully paid for using a financial account that is not linked within Monarch (such as a gift card or credit), we will not be able to find it within Monarch to categorize it. If payment was split between a non-linked payment method and a payment that is linked to Monarch, the sync will still attempt to match it.

However, even if we cannot find a match, the transaction will still appear in the extension settings in the “Orders” section, will appear as “Credits Used.”

Because these transactions paid for with methods outside of Monarch don’t affect your Monarch budget or cashflow, there is no way at this time to manually match these.

Can I re-run the sync on transactions that were already matched?

No. Once a transaction in Monarch has been matched by the sync, it will not be touched by the sync again (even if you removed the tag and notes and unsplit it). The backend system will still recognize that the transaction was previously updated by the sync and will not update it again.

What if I’ve renamed “Amazon” to a different merchant name in my settings?

You can update the extension settings to recognize the name that you are using within the Monarch app by under the "Retailer" section of the extension settings.

Can I update the default “Retail Sync” tag to a different phrase or color?

Yes, you can update the default extension tag of “Retail Sync” to use a different word or phrase, or change the color color. This change will transfer to the extension settings and the extension will use your updated version of the tag moving forward.

How does the extension work with rules that I have set up within Monarch?

Rules are applied when the order first comes into Monarch via our data providers, so the rule will be applied at the time the transaction first arrives in Monarch. The extension may then override any rules when it runs.

Why create an extension rather than build this into the app directly?

We built the Amazon integration as a Chrome extension rather than natively in the Monarch app due to technical limitations. Amazon doesn’t offer an API that would allow access to your order history, however we are able to pull this information using an extension.

This approach also enables us to provide a more stable and seamless experience without requiring users to frequently reconnect their Amazon account. While it’s not an in-app solution today, we’ve built it in a way that allows us to migrate it into the product if Amazon ever opens up an API in the future.

How does the extension use AI?

This extension uses AI (specifically Google Gemini) to process receipt data and properly categorize transactions. No personally identifiable information is ever shared and the only information passed through is what is required to analyze the order itself (i.e. item name, merchant name, price and purchase date).

What information does the extension access? What about privacy?

The extension accesses your Amazon order invoices and uses select pieces of information to help accurately categorize and split transactions, specifically the merchant name, item name, price, and purchase date. No personally identifiable information from your orders is used, stored, or sent anywhere outside of Monarch. Amazon does not have access to any of your Monarch information.

How do I update the extension?

The extension updates automatically—you’ll always have the latest version.

Need more help or to report an issue?

Click here to contact our team directly.

If you are having an issue, it would be very helpful to include the extension version, which can be found by copying and pasting chrome://extensions/ into your browser, locating the Monarch extension, and clicking "Details."