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 to Etsy, and what types of data we export to Etsy from Craftybase.
Craftybase Stock Push allows you to review and update your Etsy stock numbers directly from Craftybase, ensuring that your sales channels always reflect your actual inventory.
In this setup, Craftybase becomes your “source of truth” for stock numbers, allowing you to choose exactly when to send updates to Etsy, 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 push a stock update to 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.
- Control when updates happen - nothing is sent without your review and approval.
- Keep a record - every push is saved for easy tracking and troubleshooting.
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
You can push selected updates to Etsy whenever you’re ready. Nothing updates automatically - you stay in control.
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)
Here's an example of how it might work for a specific 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: You review and push the update. Etsy now shows 4 candles in stock.
- 4 pm: You record another manufacture, increasing stock to 9. A new draft Stock Push is created for you to review.
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.
Any stock changes made to your products will now be raised as a draft stock push.
Stock pushes will NOT occur until you action them manually from the Stock Push Activity page.
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 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.
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;