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 Stock push for Etsy and how you can use it to keep your inventory levels in sync across your connected integrations.
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.
With Stock Push enabled, Craftybase becomes your “source of truth” for stock quantities, helping you maintain consistent inventory across all of your sales channels.
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 page
- How to manually push a stock update to Etsy
- Automating stock updates with Auto-Push
- 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.
- Flexible control over stock pushes - Choose whether to send updates manually or enable Auto-Push on eligible plans to automate updates.
- Clear inventory visibility - View your Stock Push page to get an overview of all differences between platforms
How Stock Push Works
If something changes your available stock for a product (for example, you record a manufacture, adjust stock, or an order is pulled), Craftybase will automatically create a Draft Stock Push for that product.
From your Stock Push page, you’ll see a draft push showing:
- The current calculated quantity in Craftybase (this is what will be pushed)
- The current quantity pulled from integrations
- The difference between the two, for reference
By default, drafts wait for your review. If Auto-Push is enabled, Craftybase will automatically push these updates at the next scheduled interval.
When a draft is pushed to an integration, it moves through the following statuses:
- Draft → created but not sent yet
- Queued → on its way to the integration
- Completed → successfully updated
- Failed → didn’t go through (with a note explaining why)
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, you 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, select the Etsy store you wish to push stock to.
Under the Stock Push column, toggle Status to on

- On the following 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 Turn on Stock Push, and tick the box below.
- Select Save Settings 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 page
The Stock Push page gives you visibility into stock updates that have been created and sent to your integrations, as well as highlighting where stock levels differ between Craftybase and your connected platforms.
To navigate to the Stock Push page in Craftybase:
- From the top menu page, hover over the ⋮ option
- Select Stock Push

This will take you to the Stock Push tab, where you can find an overview of Draft, Queued, and Failed Stock Pushes across your connected integrations.

From here, you can also manage the settings for your connected integrations
Draft entries are created when stock levels don’t match, making it easy to spot products that may need adjustment.
How to manually push a stock update to Etsy
Manual Stock Pushing lets you review and send stock updates to your integrations under your full control. This can be helpful when you want full oversight or you're preparing your account for Auto-Push.
To perform a manual Stock Push from Craftybase:
- Navigate to the Draft tab within the Stock Push page
- Locate the Draft Stock Push you want to send to your Integration
- Confirm the stock quantity shown is expected
- Click Push to send the updated stock level to your integration
Automating stock updates with Auto-Push
Auto-Push automatically sends stock updates from Craftybase to your integrations on a set schedule, helping keep inventory accurate without ongoing manual work.
Why enable Auto-Push
- Keeps stock levels in sync across your integrations automatically
- Reduces the need to manually review and push updates
- Automatically maintains inventory accuracy across platforms
When Auto-Push works best
- Your inventory is accurate in Craftybase
- You're confident in navigating Stock Push
- You want to move to a set-and-forget approach to ongoing stock updates
If you’re still reviewing or correcting stock levels, manual Stock Pushes can help you get everything aligned first.
For detailed setup instructions and tips, see About Auto-Push.
Auto-Push is available on our Business or 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.


