Pushing Stock Updates to Etsy
Automatically export your latest stock data to Etsy using our Stock Push feature.
This article will guide you through how to set up manual and automated stock pushes for Etsy and what types of data we export to Etsy from Craftybase.
Craftybase Stock Push allows you to update your Etsy stock levels directly from Craftybase. You can choose to send updates manually by default or, if you’re on an eligible plan, enable Auto-Push so Craftybase can push updates for you on a schedule.
In this setup, Craftybase becomes your “source of truth” for stock numbers, keeping you in control of your inventory management.
Our Stock Push feature is available in Indie+ plans.
In this article, we will cover:
- Why use Stock Push?
- How Stock Push works
- Preparing Etsy for Stockpush
- Enabling Stock push for Etsy
- Viewing your Stock Push Activity
- How to manually push a stock update to Etsy
- Enabling Auto-Push for Etsy
- Important things to note
- How Craftybase handles stock pushes of zero to Etsy
- Troubleshooting
- Stock Push FAQ
Why use Stock Push?
- Stay accurate across platforms - your stock levels in Etsy match the quantities you track in Craftybase.
- Avoid overselling - If you sell something on another channel, update it in Craftybase and then quickly push the updated quantity to Etsy, no fiddly multi-channel logins required.
- Choose how your updates are sent - push manually by default, or enable Auto-Push for a hands-off workflow
- Keep a record - every push (manual or automated) is logged for easy tracking
How Stock Push Works
If something changes your available stock for a product (e.g. you record a manufacture, adjust stock, or an order is pulled), Craftybase will automatically create a Draft Stock Push for that product.
In your Stock Push list, you’ll see a draft push showing:
- The current calculated quantity in Craftybase (this is what will be pushed)
- The current quantity we have pulled from Etsy
- The difference between them for reference
By default, drafts stay waiting for your review. If Auto-Push is turned on, Craftybase will automatically push these updates at the next scheduled interval.
When you push a draft, Craftybase sends the update to Etsy. The push will then move through the following statuses:
- Draft → created but not sent yet
- Queued → on its way to Etsy
- Completed → successfully updated
- Failed → didn’t go through (with a note explaining why)
Example: Stock push for a single product
- 10 am: You record a new manufacture for your “Lavender Candle,” increasing stock from 2 to 7 in Craftybase. A draft StockPush is created.
- 2 pm: An order for 3 candles pulls from Etsy. Your stock in Craftybase drops to 4, and the draft is updated with this new number.
- 3 pm
- Manual Stock Push: You review and push the update. Shopify now shows 4 candles in stock.
- Auto-Push: Your scheduled automation run triggers, and Craftybase automatically pushes the updated stock level of 4 to your connected integrations - no manual action needed.
- 4 pm: You record another manufacture, increasing stock to 9. A new draft Stock Push is created for you to review.
- Manual Stock Push: You’ll push this update when you’re ready.
- Auto-Push: It will be automatically pushed during your next scheduled automation cycle.
Preparing Etsy for Stock Push
For Stock Push to work smoothly, Etsy variations must be set up in a way that allows inventory to be tracked to and from Craftybase.
- Variation Tracking: If your listing has variations in Craftybase but isn’t set to track variant inventory in Etsy, you’ll need to enable inventory tracking on Etsy. Without this, Stock Push can’t update quantities correctly.
- Per-Attribute Quantities: Each variation option (e.g. sizes or scent) should have its own stock quantity in Etsy. If quantities aren’t defined per attribute, Craftybase won’t be able to push updates accurately.
Example: On an Etsy store, I have a listing for a Wax Candle, with two variations, each with two attributes
- Scent - Citrus, Floral
- Volume - 100 Millilitres, 200 Millilitres
In order to ensure this is set up correctly for Stock Push, I must confirm that the Inventory is tracked for each Variant as well as that the per-attribute quantities are tracked too.
- Variation Tracking
- Navigate to the Etsy listing you are preparing
- Locate the Variations section
Ensure all of the checkboxes next to the variations are ticked, to track inventory

- Per-Attribute Quantities
- As you may have noticed in the previous screenshot, only the quantities for Scent are being tracked. We must ensure that quantities are tracked across all Attributes.
- Select Manage variations
- Turn on, Quantities vary for each ___
Select all of the variations

- Select Apply
Enabling Stock Push for Etsy
To enable and configure Stock Push for Etsy:
- Ensure you have a pre-existing Craftybase account with existing and accurate stock levels in Craftybase, alongside an Etsy shop connected as an Integration.
- Go to your Integrations page
- Under your Integrations list, locate the Etsy store(s) you wish to push stock to.
Open the actions menu and select the Stock Push Settings option.

- On the Stock Push Settings page, click the Authorize button and proceed through the reauthentication process
You will be taken to Etsy, where you will need to Grant Access to Craftybase
Note: this authentication process is only to obtain new permissions from Etsy to push data to your store, this will not impact any of your existing data or pulls.
- Scroll down until you see ENABLE STOCK PUSH FEATURE, and tick the box below.
- Select Save to confirm your changes. Stock Push is now enabled and monitoring for changes in your stock levels.
Stock Pushes will only be sent automatically if Auto-Push is enabled (Business/Growth plans). Otherwise, you will push manually.
Viewing your Stock Push Activity
To navigate to the stock push menu within Craftybase:
- From the top menu page, hover over the ⋮ option and select the Stock Push option

This will take you to the Stock Push Activity tab, which will display a list of all queued, completed, and failed Stock Pushes for all Etsy stores.
How to manually push a stock update to Etsy
to perform a stock push for a product from Craftybase to Etsy:
- Navigate to your Stock Push Activity page (How do I find my stock push page?)
- Locate the Draft Stock Push you want to send to Etsy
- Confirm the stock quantity to update is correct
- Click the Push button to push the stock level to your Etsy store.
Enabling Auto-Push for Etsy
Auto-Push lets Craftybase automatically push your stock levels to Etsy on a set schedule, so you don't need to manually create each stock push.
To enable Auto-Push for your Etsy integration:
- Navigate to your Etsy Stock Push Settings page
- Under Stock Push Automation Schedule, choose how often you'd like Craftybase to automatically push stock (Off, Daily or Hourly). This can be changed at any time.
- Click Save to apply your changes

Once enabled, Craftybase will automatically push any new stock changes on the next scheduled time - no manual action needed!
When viewing your integration’s Stock Push page, you'll also see the timestamp of the last automated push in the header, so you can confirm the most recent sync.

Auto-Push for Etsy is available on our Business and Growth plans.
Important things to note
- One draft per product at a time - if stock changes again before you push, the draft will update automatically.
- Negative quantities can’t be sent - if your Craftybase stock shows negative numbers, you’ll need to fix the issue first.
- All variations inventory must be tracked - Craftybase won't be able to push stock to a listing with variations that do not have tracked inventory.
How Craftybase handles stock pushes of zero to Etsy
Etsy’s API does not allow listings or variations to be set to a quantity of zero, so Craftybase cannot directly push a stock level of zero to Etsy. To handle out-of-stock situations, Craftybase will:
- For listings without variants: When stock reaches zero, the listing will be deactivated and its quantity adjusted to 1 (Etsy’s minimum allowed). This prevents overselling. When stock increases again, Craftybase will reactivate the listing and update the quantity to match the new stock level.
- For listings with variants: If at least one variant has positive stock, the listing remains active, and only the out-of-stock variant is set to 0. If all variants are out of stock, the entire listing will be deactivated.
- For sold-out listings: If Etsy has already marked the listing as sold out, Craftybase will reactivate it when new stock is available.
Note that any reactivations count as Etsy renewals and may incur a renewal fee.
Troubleshooting
A few potential ways an Etsy Stock Push can fail include:
| Error | Action |
|---|---|
| INVALID_INVENTORY_ITEM | The selected item couldn't be found. It may have been deleted - check your product list or try again with a different item. |
| INVALID_LOCATION | This location no longer exists. Please contact support to update or restore it |
| INVALID_QUANTITY_NEGATIVE | Quantity must be zero or positive - negative values aren't allowed. |
| INVALID_QUANTITY_TOO_HIGH | Quantity is too high - must be less than 1,000,000,000. |
| INVALID_QUANTITY_TOO_LOW | Quantity is too low - must be greater than -1,000,000,000. |
| ITEM_NOT_STOCKED_AT_LOCATION | This item isn’t stocked at the selected location. Add inventory to that location first on Etsy. |
| NON_MUTABLE_INVENTORY_ITEM | This item can’t be adjusted - try adjusting the stock levels for each child product instead. |
FAQ
How can I view my Stock Push history?
You can view push attempts and results in the Stock Push tab under Listings.
Why are some of my products not appearing in the stock push tab?
Craftybase will only push active products to Etsy. If you don’t see a product in the stockpush menu, it’s likely that the product has been archived. To fix this, double-check the product’s status and reactivate it if necessary. Once active, it will appear in the stockpush menu.
How does Craftybase push products with decimals to Etsy?
Etsy does not support tracking inventory in decimal quantities; it only allows whole numbers. Because of this, when Craftybase pushes product quantities that include decimals, the value will be rounded down to the nearest whole number before pushing to Etsy.
Example: If Craftybase shows 136.8 units, the quantity pushed to Etsy will be 136 units.
What happens if I try to push to an inactive Etsy listing?
Sometimes a listing can be changed to "inactive" by Etsy from a few common ways;
- The listing doesn't make a sale within 4 months.
- They can be manually deactivated.
- The listing has sold out.
- It may have violated Etsy's policies.
As stated by Etsy, there is an associated $0.20 USD fee to reactivate an "inactive" listing. As Craftybase will still be able to push stock to this listing, therefore reactivating it - this charge may apply.
You can read more information about how Etsy handles these fees in these articles;
Need Help?
Still have questions about setting up your Etsy shop for Stock Push? Please get in touch, and we'll be happy to help.


