ShopPilot help for AI assistants

"That page does not exist", "That action is not available here" or "Something went wrong on our side"

ID: general-error-pages

Seen as:

• "The link may be out of date. Everything is reachable from the dashboard."
• "Please go back to the dashboard and try again."
• "That action is not available here"
• "Something went wrong on our side"
• "Nothing was changed. Please try again in a moment."
• "Something went wrong on our side. Please try again."

People say: "page does not exist", "the link may be out of date", "something went wrong on our side", "that action is not available here", "a page with a Return to Shop Pilot link", "404", "error page", "it says something went wrong"

Why: These are ShopPilot's own error pages and short error lines.

• "That page does not exist" with "The link may be out of date. Everything is reachable from the dashboard." means the web address is not a ShopPilot page: an old bookmark, a mistyped address, or a link from an old message.
• "That action is not available here" with "Please go back to the dashboard and try again." means the address cannot be opened that way. It happens when an address that belongs behind a button inside the app is typed or bookmarked, or when an old page that was open for a long time asks for something the app no longer accepts.
• "Something went wrong on our side" with "Nothing was changed. Please try again in a moment." (or the shorter "Something went wrong on our side. Please try again.") means ShopPilot hit an unexpected problem while handling that one request. The request did not change anything.

Fix:

1. Press the "Return to Shop Pilot" link on the page (or open https://shoppilot.dev/app) and use the left menu instead of the old address.
2. For "That action is not available here": go back to the app, reload it and press the button again from the page.
3. For "Something went wrong on our side": wait a minute and do the same step once more.

If still stuck: contact ShopPilot support and send the exact text, the page or button you used, the shop and the time.

Notes: If the failed step was one that creates something (a listing, an order, a draft), look in "Registry", "Logs" or "Auto Orders" first to see whether the earlier try already did it, before pressing the button again.

The app says it could not reach ShopPilot, or "Network error", "Request failed", "Server error", "Could not load ..."

ID: general-connection-failed

Seen as:

• "Network error."
• "Could not load {1}"
• "Request failed ({1})"
• "Request failed ({1})."
• "Request failed:"
• "Server error ({1})"
• "Could not switch shop. Please try again."
• "Could not reach the server. Some features may not work."
• "Could not start the preview. Try again."
• "Could not start the run. Try again."
• "Preview generation failed. Check the Logs tab for details."

People say: "network error", "request failed", "server error 502", "could not load", "could not reach the server", "nothing loads", "the preview never finishes", "could not switch shop", "the site is not loading", "it keeps loading", "nothing happens when I press the button", "it stopped working", "Failed to fetch"

Why: The browser did not get a usable answer from ShopPilot. Common causes, most likely first: the internet connection dropped or the computer just woke up; a VPN, firewall, antivirus or ad-blocking extension blocks shoppilot.dev; the page has been open since before an update; ShopPilot answered with a short problem (the number in brackets: 5xx = a short problem on ShopPilot's side or on the way to it; 4xx = the request was refused, for example you were signed out). When the first page load fails the app says "Could not reach the server. Some features may not work." and some panels stay locked until the account details load. "Could not load {thing}" names what failed to load, for example "Could not load orders" or "Could not load delivery settings" (Auto Orders), "Could not load master listings", "Could not load account details" or "Could not load niche profiles. Using Phone Cases for now."; "Could not switch shop. Please try again." appears when changing the active shop could not reach ShopPilot (it already tried a few times). When a line continues after a colon, for example "Could not load orders: ...", the text after the colon is the real cause; look that text up in this page (for example the Etsy connection messages).

Fix:

1. Check that the internet works and that https://shoppilot.dev opens in a new tab.
2. Reload the page (Ctrl+F5, or Cmd+Shift+R on a Mac). If the login page appears, sign in again.
3. Try a normal window of Google Chrome. Switch off a VPN or an ad-blocking or security extension for shoppilot.dev.
4. Wait a minute and try the same step again; short problems usually clear by themselves.
5. For "Could not start the preview": nothing started; press "Preview Copy" again. For "Could not start the run": nothing is known to have started, and the copy you reviewed stays open so you can press the button again. Open "Logs" first to check that no run is already going.
6. "Preview generation failed. Check the Logs tab for details.": open "Logs" ("Listing Progress") and read the red line there, then use "How to solve".
7. The words "Failed to fetch" inside an Auto Orders line ("... The ShopPilot Bridge could not send ... from ...: Failed to fetch. Or use Upload design file on this order.") mean the browser could not reach the Bridge on your computer: open the Bridge, use Google Chrome (Safari cannot reach it), then send again, or press "Upload design file" on the order.

If still stuck: contact ShopPilot support with the exact message, the number in brackets if there is one, what you pressed, the browser and the time.

Notes: Pressing again is safe for loading, previewing and saving settings. For actions that create listings or orders, check "Registry" or "Auto Orders" first: ShopPilot refuses to make the same listing from the same folder twice by accident, but look before you repeat.

"You're using Safari": Curate and the other Bridge tools need Google Chrome

ID: general-safari

Seen as:

• "You're using Safari. Safari can't reach the ShopPilot Bridge, so Curate, your PC folders and the other Bridge tools won't work here. Open ShopPilot in Google Chrome to use them."

People say: "you're using Safari", "Safari can't reach the ShopPilot Bridge", "Curate does not work in Safari", "use Google Chrome for the Bridge", "the Bridge does not work on my Mac"

Why: Safari cannot talk to the ShopPilot Bridge on your computer, so a Mac that opens the app in Safari gets this tip once, under the title "Use Google Chrome for the Bridge". Curate, folders on your PC and the other Bridge tools need Google Chrome.

Fix:

1. Install Google Chrome on the Mac if it is not there yet.
2. Open https://shoppilot.dev/app in Chrome and sign in there.
3. Open the Bridge and check that it says "Connected", then use Curate and your PC folders from Chrome.

If still stuck: see the section "ShopPilot Bridge (desktop app)" on this page, or contact ShopPilot support.

Notes: The tip shows once in that browser; it only informs and blocks nothing.

Signed out, session expired, or the sign-in form expired

ID: general-session

Seen as:

• "Your account session has expired. Log out, then sign in again."
• "Login required."
• "This login form expired. Please try again."
• "Sign out failed. Refresh the page and try again."
• "Logout failed ({1})"
• "Activation key required"
• "This account already has a linked key, but that key is not currently active. Contact support if you need help."
• "Unable to load account."
• "You must agree to the current Terms of Service and acknowledge the Privacy Policy before signing in."
• "That key has expired."
• "This key has reached its authorized-device limit or is locked to another network. Ask the administrator to review its device access."

People say: "it logged me out", "session expired", "login required", "this login form expired", "unable to load account", "sign out failed", "that key has expired", "authorized-device limit", "you must agree to the Terms of Service", "it logs me out all the time", "I cannot log in", "it asks me to log in again"

Why: The lines about a key ("That key has expired.", "This key has reached its authorized-device limit or is locked to another network. Ask the administrator to review its device access.", "You must agree to the current Terms of Service and acknowledge the Privacy Policy before signing in.") come from the access-key sign-in page (the page where a ShopPilot key is typed instead of an email and password). An expired key needs a renewed plan; a key that is limited to certain computers or networks needs ShopPilot support to review its access; the sign-in button stays off until you tick "I agree to the Terms of Service and acknowledge the Privacy Policy". Other causes: your sign-in ended (you signed out in another tab, the session timed out, the password was changed, or you chose to log out all sessions on the account page), or the sign-in page was left open too long before you pressed the button. "Login required." is what the app answers to a request that arrives without a valid sign-in. "Unable to load account." means the account page could not read your account (usually the same reason or a short connection problem). "Activation key required" and "This account already has a linked key, but that key is not currently active" mean the account has no active ShopPilot plan or key yet.

Fix:

1. Open https://shoppilot.dev/login and sign in again with your email and password. Team members choose "Log in with your team key" and use the team key.
2. If the sign-in page says "This login form expired. Please try again.", reload the login page and type the details again.
3. "Sign out failed. Refresh the page and try again." / "Logout failed (...)": reload the page and press "Sign out" again.
4. "Activation key required" or a key that "is not currently active": open the account page and add your ShopPilot key, or start the free trial (see https://shoppilot.dev/free-trial). If you paid and the key is still not active, contact ShopPilot support with the account email.
5. "That key has expired." or the device-limit line: contact ShopPilot support with the account email and say which message you saw. If the page says "Too many attempts. Try again in a minute." wait a minute first.
6. "You must agree to the current Terms ...": tick the agreement box under the key field, then press the button.

If still stuck: contact ShopPilot support with the account email (never the password) and the exact message.

An upload is too big, or "Too many requests"

ID: general-uploads

Seen as:

• "This upload is too big for the server to accept."
• "Make it smaller (for example, save it as a JPG), or contact ShopPilot support to raise your limit."
• "MB). Send fewer or smaller files, or contact ShopPilot support to raise your upload limit."
• "or contact ShopPilot support to raise your upload limit."
• "seconds and try again. If this keeps happening, contact ShopPilot support."
• "Too many requests from your internet connection at once. Please wait a few"
• "The connection dropped while sending this file. Please try again."
• "This file could not be sent. Please try again."
• "This file is {1} MB, but files can be at most {2} MB."
• "Sending a big file ({1} MB): {2}%"
• "{1} could not be added."

People say: "file too large", "upload too big", "too many files", "upload failed", "the connection dropped while sending this file", "my image won't upload", "the file is too big", "upload stuck"

Why: Each upload has a size limit (and a limit on how many files go in one upload). The message names the size of what you sent and the limit, for example "This file is X MB, but files can be at most Y MB. Make it smaller (for example, save it as a JPG), or contact ShopPilot support to raise your limit.", or "These N files add up to X MB, but one upload can be at most Y MB. Send fewer files at a time, or contact ShopPilot support to raise your upload limit.", or "You picked N files, but one upload can hold at most M." (X, Y, N and M are the numbers shown on your own screen). Large files are sent in pieces ("Sending a big file"); if the connection drops during that, the upload stops. "Too many requests from your internet connection at once" means many requests came from your network in a short time (for example several people on one network or a script).

Fix:

1. Make the file smaller: save pictures as JPG instead of PNG, or reduce the picture's pixel size, and upload again.
2. Send fewer files in one go: upload in smaller batches.
3. "The connection dropped while sending this file. Please try again." / "This file could not be sent. Please try again.": check the internet and send the file again from the start.
4. "Too many requests ...": wait a few seconds and try again.
5. If you really need larger files, contact ShopPilot support and say what you upload and its size; support can raise your limit.

If still stuck: contact ShopPilot support with the exact message and the file's name and size.

Notes: Nothing was created by a refused upload. Trying again is safe.

"This shop is not connected to Etsy yet" and other messages about the saved Etsy connection

ID: general-etsy-not-connected

Seen as:

• "This shop is not connected to Etsy yet. Open Connect Etsy, generate the link for this shop profile, and approve it in Etsy."
• "ShopPilot could not read this shop's saved Etsy connection. Open Connect Etsy and connect the shop again to replace it."
• "ShopPilot could not check this shop profile's Etsy credentials with Etsy just now. Wait a moment and try again. If it keeps happening, re-check the Keystring and Shared Secret under Profiles."
• "ShopPilot cannot open secure storage for Etsy connections on this account right now. Nothing was changed. Please contact support."

People say: "not connected to Etsy yet", "ShopPilot could not read this shop's saved Etsy connection", "could not check this shop profile's Etsy credentials", "secure storage for Etsy connections", "it asks me to open Connect Etsy again", "it says connect Etsy", "Etsy not connected", "my shop is not connected"

Why: Every Etsy action needs a saved Etsy connection for the active shop. These lines say what is wrong with it:

• "This shop is not connected to Etsy yet. Open Connect Etsy, generate the link for this shop profile, and approve it in Etsy." The active shop has never been connected, or its connection was deleted ("Delete Saved Token", or the app was removed in Etsy's settings). Also shown when the wrong shop is active.
• "ShopPilot could not read this shop's saved Etsy connection. Open Connect Etsy and connect the shop again to replace it." The saved connection is damaged or unreadable. Connecting again replaces it.
• "ShopPilot could not check this shop profile's Etsy credentials with Etsy just now. Wait a moment and try again." Etsy did not answer the check. The text also mentions a Keystring and Shared Secret under Profiles; sellers do not enter these anywhere in the app, so skip that part.
• "ShopPilot cannot open secure storage for Etsy connections on this account right now. Nothing was changed. Please contact support." Only ShopPilot can fix this one.

Fix:

1. Make sure the right shop is active: its name is at the top of the left menu. To change it press "Manage", then "Activate" next to the shop (team members press "Switch").
2. Open "Connect Etsy" and press the connect button ("Generate OAuth Link", or "Generate New OAuth Link" when the shop was connected before).
3. Open the link that appears under "Authorization URL" in a browser that is signed in to that same Etsy shop (a Proxy shop: the browser that uses this shop's proxy) and approve on Etsy within about 10 minutes.
4. Check that "Current Token" on "Connect Etsy" shows the shop as connected, then repeat what you were doing.
5. For the credentials check: wait a minute and try again once. If it keeps coming back, reconnect the shop as above, then contact support.
6. For the secure-storage line: contact ShopPilot support and send the exact text and the shop name.

If still stuck: contact ShopPilot support with the shop name, the exact message and the time. See also the section "Connecting Etsy shops (Connect Etsy)" on this page.

Notes: Connecting again is safe: it does not change or delete any listing. Scheduled posting and Auto Orders for that shop stay paused until the shop is connected.

Etsy refused or could not complete a request (HTTP codes, rules Etsy applies)

ID: general-etsy-refused

Seen as:

• "Etsy could not complete this request"
• "Etsy could not complete {…}"
• "{…} because it rejected this shop's authorisation (HTTP {…}). Open Connect Etsy and connect the shop again."
• "{…} because Etsy no longer has that item (HTTP 404)."
• "{…} because Etsy is rate-limiting this shop (HTTP 429). Wait a few minutes and try again."
• "{…} because Etsy is having trouble right now (HTTP {…}). This is on Etsy's side -- try again shortly."
• "Etsy does not let apps change the variations of a listing that uses domestic & global pricing, so it refused this one (HTTP 400). Change its variations on Etsy.com, or remove its domestic price there, apply again here, and add the price back."
• "Etsy 403: delete permission is missing or denied. Reconnect OAuth for this shop profile so it grants listings_d."
• "Etsy request failed"
• "Etsy image request failed"

People say: "Etsy could not complete this request", "HTTP 403", "HTTP 404", "HTTP 429", "Etsy is rate-limiting this shop", "Etsy is having trouble", "Etsy request failed", "delete permission is missing", "domestic & global pricing", "Etsy error 403", "Etsy says no", "Etsy is not letting me"

Why: ShopPilot passes on Etsy's answer in plain words, with the Etsy answer code in brackets:

• (HTTP 401 or 403) "... because it rejected this shop's authorisation ... Open Connect Etsy and connect the shop again." Etsy no longer accepts the saved connection, or it lacks the permission for this action. "Etsy 403: delete permission is missing or denied. Reconnect OAuth for this shop profile so it grants listings_d." means the shop was connected before ShopPilot asked for the permission to delete listings, or the permission was removed on Etsy.
• (HTTP 404) "... because Etsy no longer has that item": the listing or order was deleted or removed on Etsy, or the list on your screen is old.
• (HTTP 429) "... because Etsy is rate-limiting this shop": Etsy limits how many requests an app can make in a short time. Wait a few minutes.
• (HTTP 5xx) "... because Etsy is having trouble right now": a problem on Etsy's side. Try again shortly.
• "Etsy does not let apps change the variations of a listing that uses domestic & global pricing, so it refused this one (HTTP 400)." Etsy only allows such a listing's variations to be changed on Etsy.com itself.
• "Etsy request failed (...)" and "Etsy image request failed (...)" mean the call to Etsy did not complete (a timeout or lost connection; the word in brackets is the kind of failure). Nothing was changed.

Fix:

1. 401/403: reconnect the shop in "Connect Etsy" (see the entry above) while signed in to the right Etsy shop, approve all permissions, then repeat the action. For the delete permission, reconnect so Etsy shows the permission list again.
2. 404: refresh the list ("Sync from Etsy" in "Bulk Edit", "Check for new orders" in "Auto Orders", or reload) and pick a listing or order that still exists.
3. 429 or Etsy trouble: wait a few minutes and retry one item first.
4. Domestic & global pricing: on Etsy.com remove the domestic price from that listing (or change its variations there), apply the change in ShopPilot, then add the domestic price back.
5. "Etsy request failed": try again in a minute. If the shop is a Proxy shop, test its proxy ("Test Active Profile Proxy" on "Proxies").

If still stuck: contact ShopPilot support with the exact message, the shop and the time.

Notes: A refused edit changed nothing on Etsy for that listing. Retrying is safe for reading and editing; for creating a listing or order, check "Registry" or "Auto Orders" first.

A Proxy shop: "Proxy required", the route to Etsy was refused, or research cannot start

ID: general-route-refused

Seen as:

• "Proxy required"
• "This shop is set to Proxy, but its proxy is missing or not working, so ShopPilot does not contact Etsy for it. Add or fix the proxy on the Proxies page, pick it under Bound proxy in Settings, then use Test Active Profile Proxy. If you don't use a proxy, switch the shop to Direct."
• "Etsy network route refused"
• "Etsy image network route refused"
• "Research transport refused"
• "Daily research transport refused"
• "The research proxy conflicts with a shop proxy. Replace one of them before researching."
• "“{1}” is on Direct now. Try again."

People say: "Proxy required but proxy failed", "network route refused", "this shop is set to Proxy", "research transport refused", "the research proxy conflicts with a shop proxy", "Use Direct", "proxy error", "proxy not working", "my shop is on proxy and nothing runs"

Why: A shop set to "Proxy" reaches Etsy only through its own proxy, and ShopPilot never falls back to Direct. "Proxy required" starts the line "Proxy required but proxy failed: ...", which says why the proxy failed. "This shop is set to Proxy, but its proxy is missing or not working, so ShopPilot does not contact Etsy for it" means the shop has no usable proxy. "Etsy network route refused (...)" and "Etsy image network route refused (...)" mean ShopPilot could not open the shop's route to Etsy (the word in brackets is the kind of failure). "Research transport refused (...)" means Market Research could not open its own route. "The research proxy conflicts with a shop proxy. Replace one of them before researching." means the Market Research proxy is the same as a shop's proxy; they must be different.

Fix:

1. Open "Proxies" and press "Test Active Profile Proxy" with the shop active. Fix or replace the proxy if it fails (see the section "Proxies" on this page for each proxy error).
2. Open "Settings" and check the shop: pick the proxy under "Bound proxy", or set the shop to Direct if you do not use a proxy. The error card may offer a "Use Direct" button: it asks first and then switches only that shop to Direct (afterwards the app says "“{shop}” is on Direct now. Try again.").
3. Market Research (paid plans): give the "Market Research Proxy" (lower on "Proxies") an address that no shop uses.
4. After the proxy works, repeat the action. A stopped plan in "Listing Scheduler" waits for you: press "Resume" on it. Auto Orders checks retry by themselves.

If still stuck: contact ShopPilot support with the exact message and the shop name (never send the proxy password).

Notes: While the route is refused nothing is sent to Etsy for that shop, so nothing is half done and trying again is safe.

Storage is full or almost full ("Until space is freed you cannot ...")

ID: general-storage-full

Seen as:

• "ShopPilot could not save this change. Check your storage usage under Account & Privacy, then try again."
• "Until space is freed you cannot:"
• "While storage is full you cannot:"

People say: "storage full", "could not save this change", "I cannot start curate", "cannot save new folders", "no space left", "storage is full", "I cannot save any more folders"

Why: The files you keep on ShopPilot (curated images, mockup and listing folders, uploads) fill the storage of your plan. ShopPilot shows "Storage N% full" and then "Running low on storage" or "Storage almost full". When it is full, you cannot start a curate run, upload Pinterest candidates or design files, or save new mockup and listing folders, and other saves can fail with "ShopPilot could not save this change. Check your storage usage under Account & Privacy, then try again." (the storage bar is at the bottom of "Settings", not on "Account & Privacy"). The line "Until space is freed you cannot:" (or "While storage is full you cannot:") introduces that list.

Fix:

1. Open "Settings": the storage bar at the bottom shows how much storage you use ("Expand details" shows more).
2. In "Curate (Pinterest)" select curated images you no longer need and press "Delete" (or "Clear all images").
3. Save finished listing folders to your PC and remove them from the server (in "Create Listings").
4. Turn off the "Save listing folders to server" switch in the top bar (shown as "Save to server" in Curate) so that future folders clean themselves up once the Bridge has saved them to your PC.
5. Try the action again.

If still stuck: contact ShopPilot support, say how much storage you need, and ask about a larger limit.

Notes: Deleting a copy on ShopPilot never deletes a listing on Etsy.

"A listing run is already in progress" and other "busy right now" messages, or a preview that cannot be read

ID: general-run-busy

Seen as:

• "A copy preview is already being written in this workspace. Try again when it finishes."
• "{…} copy previews are already being written in this workspace. Try again when one finishes."
• "Invalid preview ID"
• "That preview could not be read. Run the preview again."
• "A listing run is already in progress on {shop}. Start this one when it finishes."
• "{shop} already has a listing run in progress, started by {name} (N of M). Wait for it to finish, or work on another shop."
• "{folder} is already being listed by {name} on {shop}. Wait for that run to finish."
• "ShopPilot is already running {N} listing runs for everyone together, the most at once. Try again in a few minutes."

People say: "a listing run is already in progress", "copy preview is already being written", "already being listed by", "invalid preview ID", "preview could not be read", "it says wait", "a run is already going", "I cannot start a second run"

Why: Listing runs and copy previews are limited per account and for ShopPilot as a whole, and a folder cannot be listed in two shops at once. The message names the shop, the folder or who started it. "ShopPilot is already running N listing runs for everyone together" means ShopPilot as a whole is busy; it clears in a few minutes. "A copy preview is already being written in this workspace" means a "Preview Copy" is still running. "Invalid preview ID" means an old page asked for a preview that does not exist; "That preview could not be read. Run the preview again." means the saved preview was damaged.

Fix:

1. Open "Logs" ("Listing Progress") and look at the run that is going. Wait until it says it finished, or press "Stop" there if it is yours and you want to start over.
2. Start the new run or preview afterwards. For "already being listed ... on {shop}" wait for that run, or choose other folders.
3. For "Invalid preview ID" or "That preview could not be read": press "Preview Copy" again.
4. Scheduled posts (Listing Scheduler) that meet "busy" wait their turn by themselves; nothing is lost.

If still stuck: contact ShopPilot support with the exact message, the shop and the time.

Notes: These messages mean nothing was started. Starting again after the run ends is safe.

Listing Scheduler: a plan stopped, a time has passed, or a folder is not offered

ID: general-scheduler-form

Seen as:

• "The team member who made this plan can no longer work in this shop. Delete the plan, or make it again yourself."
• "{1} at {2} has already passed. Pick a later time."
• "{1} (not ready on the server, or already posted)"
• "another plan needs your attention."
• "Delete "{1}"? Slots that already ran stay in the timeline."

People say: "the team member who made this plan can no longer work in this shop", "has already passed. Pick a later time", "another plan needs your attention", "not ready on the server, or already posted"

Why: The Listing Scheduler checks a plan when you create it and before each post.

• "The team member who made this plan can no longer work in this shop. Delete the plan, or make it again yourself." The plan was made by a team member who was later removed from the shop, paused or moved, so the plan is parked.
• "{day} at {time} has already passed. Pick a later time." One of the planned times is in the past.
• "{shop}: another plan needs your attention." (or the plan's own message) shows above the new plan: a different plan of the same shop is stopped and shows what to fix.
• A folder that looks greyed with "(not ready on the server, or already posted)" is not offered: it is missing files, not on ShopPilot yet, or already has a listing.
• The question "Delete "{plan}"? Slots that already ran stay in the timeline." only asks you to confirm.

Fix:

1. Open "Listing Scheduler" and open the plan that shows the message.
2. A parked plan from a removed team member: delete it and make it again yourself.
3. Pick a later time or date and save the plan again.
4. A folder that is not ready: open "Create Listings", fix the folder (green = ready, orange = missing files, blue = already has a listing) and refresh.
5. A stopped plan: read its message, fix the cause, then press "Resume" on the plan.

If still stuck: contact ShopPilot support with the plan's name, the shop and the exact message.

Notes: Pausing or deleting a plan never changes a listing that is already on Etsy.

Auto Orders: "Check for new orders" cannot read a shop, or a sale email link needs a fix

ID: general-ao-check-orders

Seen as:

• "Automatic checks of this shop are paused until it is connected again on the Connect Etsy page. Check for new orders still tries it."
• "Connect an Etsy shop first, then pull from it."
• "One of the picked shops is not connected to this account any more. Pick again."
• "Orders loaded, but one or more Etsy previews were unavailable."
• "It may be shipped or canceled on Etsy already."
• "It needs a new sign-in."
• "{1}’s email needs a look."
• "{1}: email needs a fix"
• "{1}: sale emails stopped"
• "{1} can't be read"
• ", {1} could not be used (see Emails)"
• "{1} could not be used (see Emails)"
• ", {1} already in it"
• "{1} errors in Activity"
• "{1} errors in Activity."
• "Paused since {1}."
• "Not among {…}'s open Etsy orders - it may be shipped or canceled already."
• "{…} could not be read: {…} Fix that, then pull again."
• "{…} is not connected to ShopPilot. Connect it to Etsy in shop settings, then pull again: its Etsy order gives this order its SKU."
• "Could not start the {1} sign-in"

People say: "orders do not come in", "this shop can't be read", "sale emails stopped", "email needs a fix", "needs a new sign-in", "not among open Etsy orders", "automatic checks are paused", "N errors in Activity", "no new orders", "orders are not showing", "my orders do not come in"

Why: Auto Orders reads each shop's open Etsy orders (and Etsy's "You made a sale" email, when a mailbox is linked under "Sale emails") when you press "Check for new orders" and every 15 minutes by itself. These lines say what stopped it:

• "Automatic checks of this shop are paused until it is connected again on the Connect Etsy page. Check for new orders still tries it." The shop's Etsy login failed, so the automatic check pauses that shop. Pressing "Check for new orders" still tries it.
• "{shop} can't be read" (or "{shop}: proxy problem") in Activity: the last check could not read that shop's orders; the reason is shown (Etsy refusing the saved connection, a proxy that does not work, Etsy having trouble).
• "{shop}: sale emails stopped", "{shop}: email needs a fix", "{shop}'s email needs a look", "It needs a new sign-in", "... could not be used (see Emails)" ("Emails" is in the "Filters" menu of Auto Orders and lists each email with the reason; account-wide problems are in the ⋯ menu, "Activity"): the mailbox linked for that shop's sale emails wants a new sign-in (inbox.lv wants a new app password, which only the account owner can enter), stopped receiving the emails, or some older emails could not be used.
• Lines under "Not matched": "{shop} is not connected to ShopPilot. Connect it to Etsy in shop settings, then pull again", "Pick {shop} under Shops in Settings, then pull", "{shop} could not be read: ... Fix that, then pull again" and "Not among {shop}'s open Etsy orders - it may be shipped or canceled already" say why an emailed order was not matched to an Etsy order.
• "One of the picked shops is not connected to this account any more. Pick again." and "Connect an Etsy shop first, then pull from it." refer to the shop pick of the pull.
• "Orders loaded, but one or more Etsy previews were unavailable." The orders loaded; only some listing pictures could not be fetched.
• "N errors in Activity" is shown under "Automatic sending is on" with a "See" button. "Paused since {time}." means automatic sending was paused: nothing is sent by itself, you can still send by hand.

Fix:

1. Open "Auto Orders", open the ⋯ menu and choose "Activity". Each problem has a "How to fix:" line and a button ("Fix email", "Check now", "Open Settings", "Sale emails").
2. Etsy connection problems: reconnect the shop in "Connect Etsy", then press "Check for new orders".
3. Proxy problems: test and fix the shop's proxy in "Proxies".
4. Sale emails: open the shop's email settings (Auto Orders "Settings", "Sale emails"), press "Link email" or "Fix email" and sign in to the mailbox again. For inbox.lv the account owner connects it again with an app password.
5. For a not-matched order: connect and pick the selling shop under "Shops" in Settings, then press "Check for new orders" again.
6. To start automatic sending again, press the round play/pause button at the top of the page.

If still stuck: contact ShopPilot support with the shop name and the text shown in Activity.

Notes: These notices send nothing to Alerio or Gelato. An order can only be sent once it is matched.

Auto Orders: sending needs the Alerio key, a delivery service, a design or an address

ID: general-ao-sending

Seen as:

• "Add your Alerio API key in Auto Orders settings (Settings, then Alerio). Auto Orders cannot send orders to Alerio without it."
• "Optional. Without it the courier cannot send the buyer delivery updates."
• "{1} (not available)"
• "{1} is not available for {2}. Choose another service."
• "Price check passed. Cheapest delivery: {1} {2}. Nothing was created."
• "Already marked Completed on Etsy"
• "{1} already marked Completed on Etsy"
• "Nothing to mark: these orders have no tracking number yet, or are shipped on Etsy already."
• "{…} could not be marked."
• "Could not save the address"
• "The design could not be saved."
• "The design file could not be saved."
• "The picture could not be made."
• "Could not choose the image"
• "{1} more need{2} you first, whatever you answer:"
• "{1} missing a SKU, an address or another detail."

People say: "add your Alerio API key", "delivery service is not available", "design file could not be saved", "could not save the address", "already marked completed on Etsy", "price check passed", "nothing to mark", "could not be marked", "cannot send the order to Alerio", "Alerio key missing", "the order will not go to the cart"

Why: These are the checks before and after an order is sent:

• "Add your Alerio API key in Auto Orders settings (Settings, then Alerio). Auto Orders cannot send orders to Alerio without it." No Alerio API key is saved.
• "{service} is not available for {country}. Choose another service." (and "The service picked for this order is no longer offered. Choose another.") The delivery service chosen for the order does not deliver there.
• "Optional. Without it the courier cannot send the buyer delivery updates." The buyer email box on a poster order is optional; phone-case orders need it.
• "The design file could not be saved.", "The design could not be saved.", "The picture could not be made.", "Could not choose the image", "Could not save the address": saving an uploaded design file, the buyer's text on a design, the chosen original image or the corrected address failed (usually a lost connection or an unusable file).
• "Already marked Completed on Etsy" / "N already marked Completed on Etsy": the order is already marked shipped on Etsy; check before sending it again.
• "Nothing to mark: these orders have no tracking number yet, or are shipped on Etsy already." and "{...} could not be marked." belong to "Mark shipped on Etsy", used for the few shops where Etsy does not accept tracking numbers from apps.
• "Price check passed. Cheapest delivery: ... Nothing was created." is a success line of Gelato's "Price check": nothing was ordered.
• "N more need you first, whatever you answer:" appears when you switch automatic sending on and some waiting orders cannot go by themselves (personalised orders or orders with a note from the buyer, orders waiting for "Check design", orders missing a SKU, an address or another detail).

Fix:

1. Alerio key: open Auto Orders, press "Settings" (top right), group "Alerio", paste the "API key" and press "Save". The key comes from your Alerio account.
2. Delivery: open the order in "Order confirmation", and under "Delivery" choose another service, or fix the country in the address.
3. Design or address saves: reload the page, open the order and try again; use a PNG, JPG or WEBP file.
4. Completed on Etsy: look at the order in your Alerio cart and in Etsy before sending it again.
5. Mark shipped: only orders whose tracking number the print partner already has can be marked; press "Check tracking numbers" in the ⋯ menu first.

If still stuck: contact ShopPilot support with the order number, the shop and the exact message.

Notes: ShopPilot never pays in Alerio. If an order is marked "Not confirmed", look in your Alerio cart before pressing "Send it again".

Prompt Lab, alt text and other settings that "could not be saved"

ID: general-settings-not-saved

Seen as:

• "That niche no longer exists. Reload the page and pick a niche again."
• "That could not be saved."
• "That shop was not found on this account."
• "The built-in prompt could not be loaded for preview. Your listings still use it — only this preview is affected."
• "The alt text setting was not saved. Try again in a minute."
• "The setting could not be saved."
• "The link could not be removed."

People say: "that could not be saved", "that niche no longer exists", "that shop was not found on this account", "the alt text setting was not saved", "the setting could not be saved", "the link could not be removed"

Why: A single save failed. Common causes: the connection dropped, the niche or shop was deleted in another tab, or you were signed out. "That niche no longer exists. Reload the page and pick a niche again." means the niche you had open was removed. "That shop was not found on this account." means the shop to import Prompt Lab settings from is not one of your shops. "The built-in prompt could not be loaded for preview. Your listings still use it - only this preview is affected." affects only the preview in Prompt Lab. "The alt text setting was not saved. Try again in a minute." is the per-shop "Photo alt text" row in Settings. "The setting could not be saved" and "The link could not be removed" come from the SKU links list in Auto Orders.

Fix:

1. Reload the page and try the same step again.
2. If it says the niche or shop is gone, pick an existing one from the list.
3. Check that you are still signed in and the internet works.

If still stuck: contact ShopPilot support with the exact message and the page.

Notes: A failed save changed nothing; the value you see after a reload is the saved one.

Bulk Edit: a check before "Preview changes" or "Apply to selected" stops the edit

ID: general-bulk-edit

Seen as:

• "Etsy refuses a title in which more than three words start with two capital letters. Write some of them in lower case."
• "The materials could not be read from Etsy yet."
• "Tick the box to confirm Etsy’s listing fee first."
• "Select listings first."
• "Nothing would change."
• "Already as asked, nothing to change."
• "Nothing to preview."
• "Nothing matches that."
• "fits on {1} of {2}, the others are full"
• "full, so “{1}” won’t fit"
• "{1} at Etsy’s {2} limit"
• "the ones worth a look first."
• "Don’t add to the other {1}"
• "already has "{1}""
• ""{1}" is already in this list."
• "{1} more first."
• "Sync from Etsy first, then select the listings to group."
• "Nothing synced yet."
• "Failed to load listings"
• "Could not read the materials from Etsy."
• "Could not read the variations from Etsy."

People say: "Etsy refuses a title with more than three words in capitals", "tick the box to confirm Etsy's listing fee", "select listings first", "nothing would change", "materials could not be read", "failed to load listings", "full, so it won't fit", "bulk edit does not work", "the Preview button is grey", "cannot apply the change"

Why: "Bulk Edit" (left menu, Manage; the page is "Bulk Edit Listings") edits your live Etsy listings. It first reads them with "Sync from Etsy", you tick the listings, pick the edit, and a line above the buttons says what would happen ("Changes N of M ... N can't: reason"). The buttons stay greyed with a hint until the edit makes sense:

• "Select listings first." / "Nothing synced yet": tick listings; nothing is loaded until you press "Sync from Etsy". "Failed to load listings" means the sync did not finish (connection or Etsy problem).
• "Nothing would change." / "Already as asked, nothing to change." / "Nothing to preview.": every ticked listing already has the wanted value.
• Title rules: Etsy refuses a title in which more than three words start with two capital letters ("Etsy refuses a title in which more than three words start with two capital letters. Write some of them in lower case."); "&" only once; at most 140 characters ("N at Etsy's 140 limit" counts titles already at the limit).
• Tags and materials: a listing with all 13 tag places taken shows "full, so "{tag}" won't fit" or "fits on N of M, the others are full"; "Don't add to the other N" undoes an add on the rest. "Nothing matches that." is an empty filter. "The materials could not be read from Etsy yet." / "Could not read the materials from Etsy." / "Could not read the variations from Etsy." mean Etsy did not return them in time: try again.
• Status changes that cost an Etsy listing fee (publishing drafts, renewing expired listings, putting sold-out listings back on sale): "Tick the box to confirm Etsy's listing fee first." Tick "I understand Etsy charges this fee" to go on.
• Models (variations): "Etsy allows 70 models on one variation. Remove N more first.", '"{name}" is already in this list.', 'already has "{name}"', "Sync from Etsy first, then select the listings to group." and the preview note "the ones worth a look first" (the preview shows the listings most worth checking first).

Fix:

1. Press "Sync from Etsy", tick the listings, and read the line above "Preview changes".
2. Fix what it names (shorter title, fewer capitals, remove a tag, tick the fee box), then press "Preview changes". It shows the exact before and after for every listing.
3. Check the preview, use "Leave out" for listings you do not want to change, then press "Apply these changes" (or "Apply to selected").
4. If a read fails (materials, variations, Failed to load listings): wait a minute and press "Sync from Etsy" again.

If still stuck: contact ShopPilot support with the exact line and what you chose to edit.

Notes: Every edit is written straight to Etsy and cannot be undone from here, so always preview first. Bulk Edit changes only the listings you ticked. If a batch ends with "ShopPilot did not answer this batch (HTTP 502)" some of it may already be on Etsy: press "Sync from Etsy" and look before you apply again.

Curate: a collection could not be started or finished, or a note about collected images

ID: general-curate-lines

Seen as:

• "Couldn’t start collecting “{1}”: {2}."
• "Couldn’t finish collecting {1}{2}{3}"
• "Already collected {1}/{2}"
• "{1}: {2} already collected"
• "· {1} image{2} already collected"
• "You already have {1} collected image{2} for this collection."
• "Using {1} image(s) already collected for “{2}”"
• "{1} No empty server fallback was started."
• "Paused after {1} of {2} collection{3}."
• "Paused — {1} of {2} collection{3} done."
• "Image matching setup needs attention: {1}."
• "Set {1} is full · the next image starts Set {2} in a new color."
• "These designs could not be saved for the set. Keep exactly {1} image tab{2} open, one for each picked design, then press Continue again."
• "{1} stopped before finishing. Open the log below for the reason."
• "Download failed: {1}"
• "Download failed ({1})"
• "Could not load style ({1})."
• "Could not save style ({1})."
• "Could not delete "{1}"."
• "Could not rename "{1}"."
• "Delete "{1}" and all of its references, sets, and learning? This cannot be undone."
• "Hand-edited for {1} — auto-learning paused (Reset to resume)."
• "Saved automatically. Auto-learning paused here (Reset to resume)."
• "Empty style not saved — use Reset to clear the learned style."
• "Auto-save failed"
• "Auto-save failed — your style is still in the editor."
• "Could not save curator settings."
• "Could not save curator settings:"
• "Could not save curator style:"
• "Could not save settings"

People say: "couldn't finish collecting", "paused after 2 of 5 collections", "already collected", "image matching setup needs attention", "no empty server fallback was started", "auto-save failed", "could not save curator settings", "set is full", "curate stopped", "curate paused", "curate did not finish"

Why: These are the status lines of "Curate (Pinterest)". Pinterest images are collected on your computer by the ShopPilot Bridge, one search at a time.

• "Couldn't start collecting "{name}": {reason}." / "Couldn't finish collecting {name}: {reason}." The collection stopped for the reason shown (Bridge closed or lost, Pinterest cookies missing, Pinterest limits). What was collected is kept.
• "Paused after N of M collections." / "Paused - N of M collections done." You pressed "Stop" or the run was interrupted; "Continue unfinished curate" picks up from here.
• "Already collected N/M", "{name}: N already collected", "N images already collected", "You already have N collected images for this collection." and "Using N image(s) already collected for "{name}"": nothing is fetched twice; the run reuses images it already has.
• "... No empty server fallback was started.": the Bridge is not ready and Curate will not run without it; open the Bridge (see the Bridge section) and press the button again.
• "Image matching setup needs attention: ..." / "... stopped before finishing. Open the log below for the reason." / "These designs could not be saved for the set. Keep exactly N image tabs open, one for each picked design, then press Continue again.": read the reason in the log under "5. Run", fix it, run again.
• "Set N is full - the next image starts Set M in a new color." is information: a phone-case set holds five images.
• "Auto-save failed" / "Could not save curator settings" / "Could not save settings" / "Could not load style" / "Could not save style" / "Could not delete" / "Could not rename": a collection's settings or style were not saved or loaded (connection lost or you were signed out). "Empty style not saved - use Reset to clear the learned style." means the style box was empty. "Hand-edited ... auto-learning paused (Reset to resume)" and "Saved automatically. Auto-learning paused here (Reset to resume)." mean ShopPilot stops updating the learned style while you edit it by hand; "Reset" lets it learn again.
• The question "Delete "{name}" and all of its references, sets, and learning? This cannot be undone." only asks for confirmation.

Fix:

1. Open the Bridge, keep it open and paired, then press "Continue unfinished curate" (or the run button again).
2. For a save that failed: reload the page and make the change again.
3. For "Image matching setup": wait a minute (the setup finishes in the background), then press the run button again.

If still stuck: contact ShopPilot support with the collection name and the exact line from the log under "5. Run".

Notes: Continuing is safe: it does not collect the same images twice. Deleting a collection removes its references, sets and learned style from ShopPilot only.

Create Mockups: a PDF or design could not be used, or a folder stayed on the server

ID: general-mockups-lines

Seen as:

• "Could not read that PDF: {1}"
• "{1} PDF{2} could not be used: {3}"
• "{1} design{2} could not be fitted: {3}"
• "This design is {1} MB{2}, over the {3} MB limit."
• "Could not copy {1} to your PC: {2}. Kept on the server only."
• "Could not copy {1} to your PC{2} - kept on the server only."
• "Finished with problems: {1} saved, {2} stopped and saved nothing."
• "{1} saved · {2} failed"
• "{1} saved. {2}{3} produced nothing — see the log."
• "Finished · {1} saved, {2} failed"
• "Mockup run failed:"
• "Could not load the mockup editor:"
• "Could not open your original file. PNG, JPG and WEBP files work here."
• "Could not save — try one more edit"
• "The original file is not available for this design."
• "Downloaded {1} of {2} image{3} — {4} failed"

People say: "could not read that PDF", "design could not be fitted", "design is over the MB limit", "kept on the server only", "finished with problems", "could not open your original file", "could not load the mockup editor", "my PDF won't upload", "mockups finished with problems", "the folder is not on my computer"

Why: These come from "Create Mockups", the design upload, the Mockup Editor and the save step.

• "Could not read that PDF: ..." / "N PDFs could not be used: ...": a PDF could not be turned into a design (the file is empty, not really a PDF, damaged, could not be opened as an image, or becomes too large a picture; the text after the colon says which). Only page 1 of a PDF is used ("Only page 1 was used from ...").
• "N designs could not be fitted: ...": the automatic design placement ("Auto prep") could not fit those designs; open them in the mockup editor and place them by hand.
• "This design is X MB, over the Y MB limit. Flatten the layers, downsample it to 300 DPI, or save the PDF without embedded originals, then try again."
• "Could not copy {folder} to your PC: ... Kept on the server only." / "... - kept on the server only." The Bridge could not save the finished folder on your PC (closed, no folder chosen, no space). The folder is safe on ShopPilot. Use "Save to PC" in Create Listings once the Bridge works. The app may also start a zip download of the folder as a fallback.
• "Finished with problems: N saved, folder K stopped and saved nothing." / "N saved - folder K failed": most folders were made, one produced nothing. Details are in the log under the buttons.
• "Mockup run failed: ...": the run stopped for the reason shown.
• Mockup Editor: "Could not load the mockup editor. Please try again." (reload the page and open it again), "Could not open your original file. PNG, JPG and WEBP files work here.", "The original file is not available for this design.", "Could not save - try one more edit", and "Downloaded N of M images - K failed" (some of the editor's images could not be downloaded; try those again).
• "Save {n} to PC first": a live listing folder is only on the server; the app asks you to save it to your PC before it deletes it.

Fix:

1. For PDFs: export the page as PNG, JPG or WEBP and upload that, or reduce the PDF (300 DPI, flattened).
2. For "kept on the server only": open the Bridge, check it says "Connected", then use "Save to PC" in "Create Listings".
3. For editor messages: reload the page, open the design again and retry.
4. For a folder that "stopped and saved nothing": run it again; if it stops again, contact support.

If still stuck: contact ShopPilot support with the folder number and the line from the log.

Notes: Nothing is deleted from your PC by these messages.

"Upload folders" (Create Listings): no supported files, files skipped, or the batch failed

ID: general-folder-upload

Seen as:

• "Your browser doesn't support folder picking. Try Chrome, Edge, or use the Mobile version tab."
• "No supported image files were found in the selection."
• "No supported listing folders found."
• "{1} files were skipped (unsafe path or unsupported type)."
• "Could not read the response for batch {1}."
• "Could not add folders:"
• "Type a listing name first."
• "({1} already on server, skipped)"

People say: "no supported image files were found", "no supported listing folders found", "files were skipped", "your browser doesn't support folder picking", "could not add folders", "type a listing name first", "I cannot upload my folder", "upload folders does not work"

Why: "Upload folders" on "Create Listings" sends listing folders from your computer to ShopPilot (a window called "Upload folders from your computer"). On a computer the browser lets you pick a parent folder and tick the listing folders inside; on a phone you type a listing name and pick photos, which become one listing folder. ShopPilot accepts only picture and design files (jpg, jpeg, png, webp, gif, bmp, tif, tiff, psd, svg), paths that are not too deep, and file names Windows accepts. Anything else is skipped: "N files were skipped (unsafe path or unsupported type)". "Your browser doesn't support folder picking. Try Chrome, Edge, or use the Mobile version tab." means the browser (for example Safari or Firefox) cannot pick a whole folder. "Could not read the response for batch N" and "Network error." mean the connection dropped during a batch.

Fix:

1. Use Google Chrome or Edge on a computer. On a phone choose the Mobile version tab, type the listing name ("Type a listing name first.") and pick at least one photo.
2. Pick the parent folder that holds your listing folders, tick the folders and press "Use selected". Folders must contain pictures.
3. Rename files or folders that contain characters such as < > : " | ? * or end with a dot or space, and remove very deep sub-folders.
4. Remove files of other types (zip, pdf, docx) from the folder, or convert them to PNG or JPG.
5. After a connection problem press the button again: folders that are already on the server are skipped ("N already on server, skipped").

If still stuck: contact ShopPilot support with the folder name, the browser and the exact text.

Notes: Uploading again is safe; nothing is uploaded twice. If you use the Bridge you can skip this window: the Bridge reads folders on your PC directly (see the Bridge section).

Account page: plan change, password, sign out everywhere, disconnect Etsy

ID: general-account-page

Seen as:

• "Could not start the change. Nothing was charged."
• "Nothing (the difference is under €1)"
• "Could not disconnect Etsy."
• "Etsy disconnected"
• "The password could not be changed. Try again."
• "Could not log out your other sessions. Try again."

People say: "could not start the change, nothing was charged", "the password could not be changed", "could not log out your other sessions", "could not disconnect Etsy", "Etsy disconnected"

Why: These short lines come from the account page (https://shoppilot.dev/dashboard). "Could not start the change. Nothing was charged." means a plan change did not start; nothing was charged. "Pay now: Nothing" in the quote for a plan change means no payment is needed for that change. "The password could not be changed. Try again." and "Could not log out your other sessions. Try again." mean the request was refused or did not arrive (wrong current password, a new password shorter than 12 characters, or a lost connection). "Etsy disconnected" confirms that ShopPilot's saved Etsy access was removed; "Could not disconnect Etsy." means that did not work.

Fix:

1. Reload the account page and try the step again.
2. For the password: type the current password correctly and a new one of at least 12 characters.
3. For disconnecting Etsy: try again, or remove ShopPilot under Apps in your Etsy account settings.
4. For a plan change that does not start, see https://shoppilot.dev/pricing and the "Subscription & Payments" tab of the account page; if it keeps failing, contact ShopPilot support with the account email.

If still stuck: contact ShopPilot support with the account email and the exact message (never send a password or card details).

Notes: After "Etsy disconnected" the shop must be connected again in "Connect Etsy" before ShopPilot can list, edit or send orders for it.

Background Changer: sending a folder or saving a preset failed

ID: general-bgc

Seen as:

• "Could not send {1} ({2})."
• "Processing failed ({1})."
• "Save failed: {1}"
• "Already in the list: {1}."

People say: "could not send the folder", "processing failed", "save failed", "already in the list"

Why: "Background Changer" (left menu, Tools) sends the folders you add to ShopPilot in batches, changes the background and saves JPG copies. "Could not send {folder} ({code})." means a batch did not arrive; "Processing failed (code)." means ShopPilot could not finish a folder; "The server is busy. Please try again in a minute." means too many jobs are running at that moment. "Save failed: ..." comes from saving a colour preset. "Already in the list: {folder}." means you added the same folder twice (it is added once).

Fix:

1. Keep the Bridge open if the folders were picked through it ("The Bridge could not read {file}. Keep the Bridge open, or choose the folders again.").
2. Check the connection, wait a minute and press the button again.
3. Add the folders again if the list was cleared.

If still stuck: contact ShopPilot support with the folder name and the exact message.

Notes: Results are saved as JPG copies in output folders named after the colour preset.

"Save to PC" or "Delete from server" in Create Listings did not do everything

ID: general-save-delete-folders

Seen as:

• "Could not save: {1}"
• "Save {1} to PC first"

People say: "could not save: folder (failed)", "save it to PC first", "live listing is not saved on this PC yet", "kept on the server"

Why: "Save to PC" copies finished folders from ShopPilot to your computer through the Bridge. "Could not save: {folder} ({reason})" lists the folders that failed and why (Bridge closed, no folder chosen, folder name in the way, no disk space). "Delete from server" frees storage by removing the server copy only. A folder whose listing is live on Etsy and is not saved on your PC yet is held back, with the button "Save it to PC first" ("Save N to PC first"), so you cannot lose the only copy by accident.

Fix:

1. Open the ShopPilot Bridge, check that it says "Connected" and that the shop's listings folder (set in "Niches") exists on this PC.
2. Press "Save to PC" again for the folders that failed.
3. When the dialog offers "Save it to PC first", press it, wait for it to finish, then delete from the server.

If still stuck: see the Bridge section on this page, or contact ShopPilot support with the folder names and the exact message.

Notes: Delete from server never touches the copy on your PC and never deletes anything on Etsy.

Smart mockup marker: "The product's own edges could not be seen"

ID: general-marker-note

Seen as:

• "The product's own edges could not be seen beside the print, so it is set to go most of the way round. Set how far under Wraps round."

People say: "the product's own edges could not be seen", "wraps round"

Why: When you mark the four corners of the print area on a photo of a round product (for example a mug), ShopPilot works out how far the print wraps round the product from the product's outline. If the outline is hard to see in the photo it sets a default (most of the way round) and shows this note.

Fix:

1. Check the preview of the print on the product.
2. Set "Wraps round" in the marker panel by hand until the print looks right, then save the mockup.
3. A photo with the whole product visible against a plain background works best.

Notes: This is a hint, not a failure; the mockup can still be saved.

Short notices that look like problems but are not ("Nothing to do", "Already in the list", "Nothing changes")

ID: general-notices

Seen as:

• "Nothing to do"
• "Nothing changes."
• "Nothing in {1} right now."
• "Nothing ticked: {1} has no {2} tab."
• "{1} already in the list."
• "{1} {2} already {3} it."
• "Don't show again"
• "Found in a preview; nothing was made on Etsy."
• "· totals unavailable"
• "“{1}” is already being monitored."
• "Canvas is already {1} × {2}"
• "There is already a section called “{1}”. Choose another name."
• "No images found for this folder."

People say: "it says nothing to do", "already in the list", "nothing changes", "canvas is already", "there is already a section called"

Why: These lines only tell you what ShopPilot found or did not do:

• "Nothing to do", "Nothing changes.", "Nothing in {name} right now.": there was nothing left to process.
• "{name} already in the list.", "Already in the list: {name}.", "There is already a section called "{name}". Choose another name.": you added something twice; use a different name.
• '"{name}" is already being monitored.' (Market Research) and "Canvas is already W x H." (Mockup Editor): the thing you asked for is already set.
• "Nothing ticked: {shop} has no {tab} tab.": in Settings, Organization, the shop has nothing of that kind to tick.
• "Found in a preview; nothing was made on Etsy.": a listing you see comes from "Preview Copy", not from Etsy.
• "Don't show again for this niche" hides that hint.
• "totals unavailable": Market Research could not add up the totals for that list.
• "No images found for this folder." (Registry): the folder has no pictures.

Fix:

1. Nothing is wrong. Continue, pick another name, or reload the list if you expected something to be there.

If still stuck: contact ShopPilot support with the exact text and the page.

Rare messages: Etsy did not answer, listing generation unavailable, copying blocked

ID: general-rare

Seen as:

• "ShopPilot could not reach Etsy. This is usually brief -- wait a moment and try again."
• "Listing generation is temporarily unavailable on this account. Nothing was charged and no listing was created. Please contact support."
• "Batch {1} failed."
• "Could not copy. Select the text and copy it yourself."

Why: These appear only in unusual situations.

• "ShopPilot could not reach Etsy. This is usually brief -- wait a moment and try again.": Etsy did not answer; wait a minute and retry.
• "Listing generation is temporarily unavailable on this account. Nothing was charged and no listing was created. Please contact support.": ShopPilot's AI writer cannot be used on the account right now. Only ShopPilot can fix it.
• "Batch N failed." ("Upload folders"): one batch of files did not arrive; press the button again (folders already on the server are skipped).
• "Could not copy. Select the text and copy it yourself.": the browser blocked copying to the clipboard; select the text and copy it with Ctrl+C (Cmd+C on a Mac).

Fix:

1. Reload the page and try once more.
2. If the text mentions support, contact ShopPilot support.

If still stuck: contact ShopPilot support with the exact message, the page and the time.

Not errors: labels and notes (app-wide)

ID: general-not-errors

Seen as:

• "Choose Direct or Proxy for the shop. A new shop is already on Direct. If you use proxies, choose Proxy and add your proxy."
• "{1}, pick its {2} pictures first: open"
• "The folders in this niche’s listings folder show up here. **Green** is ready, **orange** is missing files, and **blue** already has a listing. Nothing here yet? Check the folder in Niches, and that the Bridge is running."
• "**Save master listing** saves every tab at once. **Close** shuts the editor, and anything not saved is lost."
• "No generated title saved"
• "Your wall with an empty picture frame on it, or your desk with a"
• "Required Keywords"
• "When a loaded design is too small for a sharp print, upscale it automatically on your Bridge"
• "Etsy refuses a physical listing without one."
• "Each row is a value a buyer can pick. Give it its own price or quantity, or leave them empty to use the price at the top."
• "After it is made, nothing is read from Etsy again. Changing the Etsy listing later does not change the master."
• "A short guided setup connects the essentials your first shop needs. It starts in Settings and asks how the shop reaches Etsy: Direct, with nothing extra to set up, or through a proxy of your own."
• "Duplicate layer"
• "{1}, nothing is needed: it uses all {2} pictures."
• "Nothing here? Tell us what you would build"
• "**Use phone case built-in master** is ready at once: Etsy’s phone-case category, 12 photo slots and 70 phone models × 5 designs. **Add from Etsy** copies one of your own listings, once. **New blank master** starts empty."
• "Something missing, or need a hand?"
• "(folder no longer on disk)"
• "One per line. **Banned Words** never appear in a title, tag, description or hashtag. At least one **Required Keyword** shows up in each title or tag set."
• "Each ticked template becomes one photo in every listing. The ones marked **Always included** cannot be unticked."
• ", and {1} {2} already listed"
• "Final title shape. Must contain {design_name} and {style}. Etsy hard limit is 140 chars."
• "Forget this link? Later orders of the listing will ask for the SKU again. Orders that already have it keep it."
• "Folder is no longer on disk — images unavailable."
• "Nothing printed on it yet, and the print area in full view."
• "A master does nothing on its own. In **Niches**, choose it for the product type and shop it is for, and every run there builds from it."
• "The AI writes each listing from its first photo. Prompt Lab sets the rules it follows: the title pattern, how many tags, words it must never use and words it must include."
• "Etsy Image Limit"
• "This box is your collection's taste memory. After your first 3 picks, ShopPilot writes down what you like, and every run leans toward it. The AI that matches pictures to words can't understand “not”, so only FAVOR words choose which designs get picked. AVOID words steer the Pinterest searches instead."
• "One master can serve many shops and niches. To change it for one shop only, press **Duplicate** and choose the copy on that shop’s niche. **Remove** takes a master out of your library; nothing on Etsy is deleted."
• "**Create Draft** makes drafts you can check on Etsy first. **Create + Publish Live** puts listings in front of buyers straight away."
• "Different for one shop? Duplicate it"
• "Leave blank unless ShopPilot auto-detects the wrong variation property. If needed, enter only Etsy's numeric property ID."
• "images cannot be read yet."
• "needs files"
• "Paste the exact full folder path used on the computer running ShopPilot Bridge. It must contain listing folders such as f1, e2, or art10."
• "pick up, or picks up wrongly."
• "A number on a folder is its place in the queue. Greyed folders are already in another plan. A hollow ring means the folder is still on your PC: it uploads when you start the plan."
• "A saved change reaches the next run of every shop that uses this master. Listings already on Etsy stay as they are."
• "Without {{INTRO}} the opening goes at the top, and without {{HASHTAGS}} the hashtags go at the end. The **Insert** buttons put one where you click."
• "— choose which side its top faces. Designs that already fit,"
• "Every time a plan ran, with each folder’s result. A failed folder says why. In a weekly plan it gets one more try later, and if three runs in a row fail, the plan stops and says what to fix."
• "Slot 1 leads the listing, and the AI writes the description from it. Folders made by Create Mockups already use these names."
• "Everything a new shop needs before its first listing, in the order you do it."
• "partial / needs attention"
• "Required to fulfil posters through Gelato. Each shop uses its own Gelato account and is billed separately, so a key is never shared between shops. A saved key stays in place unless you type a replacement."
• "**Green** is ready. **Orange** is missing files, so hover it to see which. **Blue** already has a listing, so a second one is not made by accident."

Sign-up is refused or the form shows an error

ID: account-signup

Seen as:

• "Enter a valid email address."
• "Use at least {…} characters for the password."
• "Use no more than {…} characters for the password."
• "Choose a different password."
• "The password must not contain your email name."
• "The password confirmation does not match."
• "You must agree to the Terms of Service and acknowledge the Privacy Policy."
• "The legal documents changed. Review and accept them again."
• "Unable to create an account with those details."
• "Use a permanent email address. Temporary inbox addresses can't be used for a Shop Pilot account."
• "That email domain doesn't receive mail. Check the address and try again."
• "This signup form expired. Please try again."
• "Review the highlighted requirement and try again."
• "Type your Gmail address without the dots. Gmail ignores dots, so mail still reaches the same inbox."

People say: "I can't create an account", "it says unable to create an account with those details", "my password is not accepted", "it says use a permanent email address", "sign-up form expired"

Why: The sign-up form checks each field. The email must be a normal address that can receive mail: temporary inbox addresses are refused, a domain that does not receive mail is refused, and a Gmail address with several dots in the name must be typed without the dots (Gmail delivers to the same inbox either way). The password must have at least 12 and at most 128 characters, must not be only spaces, must not contain the part of your email before the @ (when that part has 4 or more characters), and must match "Confirm password". The Terms of Service box must be ticked. "Unable to create an account with those details." is a general message for a rare failure: it does not say which detail. An email address that already has an account does not get this message: the form goes on to the code page and no code is sent (see The 6-digit email code never arrives, or the code or confirm button does not work). "This signup form expired" (and the same wording on other ShopPilot forms) means the form's security check no longer matches: the page was open for a long time, another tab changed the session, or the browser blocks cookies for shoppilot.dev.

Fix:

1. Read the message under the field and fix that field. Type the email by hand and check it for typos.
2. Use a password of at least 12 characters that does not contain your email name. Press "Show" to check both password boxes match.
3. Tick "I agree to the Terms of Service and acknowledge the Privacy Policy."
4. If the form expired, open https://shoppilot.dev/signup again (do not use the Back button), make sure cookies are allowed for shoppilot.dev, and fill it in again.
5. If the form goes on to the "Confirm your email" page but no email arrives, the address may already have an account. Try https://shoppilot.dev/login, or "Forgot password?" there. The address also gets a short notice email when someone uses it to sign up again.
6. Use an email address you keep and can read (Gmail, Outlook, inbox.lv and similar). Do not use a temporary or throw-away inbox.

If still stuck: contact ShopPilot support with the email address you tried and the exact message. Never send the password.

Notes: Trying again is safe. An account whose email was never confirmed cannot be used yet: log in with the same email and password to get to the code page again.

Too many tries: wait and try again (sign-in, sign-up, codes, reset, password changes)

ID: account-too-many-tries

Seen as:

• "Too many sign-in attempts. ... Forgot your password? Use Forgot password. You can try again in about {…} minutes."
• "Too many sign-up attempts. ... You can try again in about {…} minutes."
• "Too many password-reset requests. ... No email was sent this time. You can try again in about {…} minutes."
• "Too many new codes asked for. ... You can try again in about {…} minutes."
• "Too many codes tried. ... You can try again in about {…} minutes."
• "Too many password changes. ... You can try again in about {…} minutes."
• "Too many codes were requested. Try again in {…} minute{…}."
• "Too many codes were tried today. Use the button in the email, or try again tomorrow."
• "Too many new codes were asked for today. Use the newest email, or try again tomorrow."
• "Too many tries."
• "Wait {…} minute{…} and try again."
• "Too many tries"
• "Too many tries. Wait {…} and try again."

People say: "too many attempts", "I am locked out", "it says try again in 15 minutes", "login blocked", "too many tries"

Why: To protect accounts, ShopPilot refuses further tries for a while after too many sign-in attempts, sign-ups, password-reset requests, codes or password changes in a short time. Until the wait is over the next tries are refused, even if the details are now correct. The message gives the wait, for example "about 9 minutes".

Fix:

1. Stop pressing the button. Wait the time the message gives.
2. Try once, typing the email and password slowly. Press "Show" to check the password.
3. If you are not sure of the password, use "Forgot password?" on the login page instead of guessing again.
4. For codes: after the wait, use the newest email. If the page says to try again tomorrow, use the button in the newest email instead of typing the code, or wait until the next day.
5. If you urgently need access and cannot wait, contact ShopPilot support.

If still stuck: contact ShopPilot support with your account email, the time, and the exact message.

Notes: Waiting never harms the account. Do not try to get around the wait by creating a second account.

The 6-digit email code never arrives, or the code or confirm button does not work

ID: account-email-code

Seen as:

• "That code is invalid or expired. Use either of your two most recent emails or request another code."
• "The verification email could not be sent. Wait briefly and try again."
• "The verification email could not be sent. Check the address and request a new code."
• "Your email isn't confirmed yet. Use the code or the button from the email we sent."
• "This secure verification form expired. A fresh protected form is ready; enter either of your two most recent unexpired codes or reopen either recent email link."
• "This isn't the browser you signed up in."
• "This link has expired."
• "This link doesn't work."
• "Email already confirmed."
• "This tab was opened by your email app and cannot send forms."
• "Sign in again to send a new verification code."
• "Choose a valid verification action."
• "Open this page in the same browser where you created or signed in to this account."
• "Use the email address for the account signed in to this browser."

People say: "I didn't get the code", "the code is invalid or expired", "the confirm link doesn't work", "this isn't the browser you signed up in", "verification email not coming"

Why: The code and the button in the "Confirm your email" email work for 30 minutes, once, and only in the same browser where you created the account (or logged in). The two newest emails both work, older ones do not. Common causes: the email is in spam or was typed with a typo; the code is older than 30 minutes; the button was opened on another device or in another browser (for example the phone's mail app); the email was opened inside a mail app tab that cannot send forms; too many codes were asked for. If the email address already had an account, no new code is sent for the sign-up; the address gets a notice instead.

Fix:

1. The code page says "Check your spam folder first." Look in Spam or Junk and under the other tabs of the mailbox (Gmail "Promotions", Outlook "Other"). Search for "ShopPilot". Give the email a few minutes before asking for another code.
2. Open https://shoppilot.dev/verify-email in the SAME browser where you signed up and type the newest code. It is fine to paste it ("604 960" works).
3. "This isn't the browser you signed up in": open the email in the original browser and press the button again, or log in here and type the 6-digit code.
4. "This link has expired" or "That code is invalid or expired": press "Send a new code" (or "Send a new link") and use the newest email. Do not use a code from an older email than the two newest.
5. "This tab was opened by your email app and cannot send forms": open a new browser tab, go to shoppilot.dev/verify-email and type the code there.
6. "Your email isn't confirmed yet" appears when you log in before confirming: use the code or the button from the email.
7. "Sign in again to send a new verification code": log in at https://shoppilot.dev/login with the email and password you used, then press "Send a new code".
8. If the email address was typed wrongly at sign-up, the code went to a wrong inbox. Sign up again with the right address.
9. "Email already confirmed." means you are done: log in.
10. If nothing arrives after about 10 minutes, press "Send a new code" once, check Spam again, and then contact ShopPilot support with the email address and the time.

If still stuck: contact ShopPilot support with the email address, the time you asked for the code, and the exact message.

Notes: Trying again is safe. Asking for many new codes in a short time is refused for a while (see Too many tries: wait and try again (sign-in, sign-up, codes, reset, password changes)).

Log in fails: wrong password, expired form, "Your login took too long"

ID: account-login

Seen as:

• "Your login took too long. Log in again."
• "This page expired. Please try again."
• "Email or password is incorrect."

People say: "can't log in", "email or password is incorrect", "login form expired", "login took too long", "the login page loops back"

Why: "Email or password is incorrect." means the pair did not match; it does not say which one is wrong. Usual causes: a typo, an old password after a reset, the wrong email (a second address), caps lock, or a password manager filling an old password. "This login form expired" and "This page expired" mean the page was open too long: reload it. "Your login took too long" appears when you passed the password step of 2-step login but did not enter the code in time (it waits for several minutes).

Fix:

1. Open https://shoppilot.dev/login again (reload the page) and type the email and password. Press "Show" to see the password.
2. If the password may be wrong or forgotten, press "Forgot password?" (see Forgot password: the reset link or the reset form does not work).
3. If you have 2-step login, enter the 6-digit app code on the next page within a few minutes.
4. If you created the account but never confirmed the email, logging in sends you to the code page: enter the 6-digit code from the email.
5. A team member does not use this page: use "Log in with your team key" or https://shoppilot.dev/team/login.

If still stuck: contact ShopPilot support with the email address and what the page says. Never send the password.

Notes: Many wrong tries in a row make ShopPilot refuse further tries for a while (see Too many tries: wait and try again (sign-in, sign-up, codes, reset, password changes)).

2-step login: the 6-digit app code or backup code is refused

ID: account-2step-login

Seen as:

• "Too many wrong codes. Log in again."
• "Too many wrong codes. Wait {…} and try again."
• "We can't check app codes right now. Use a backup code, or try again later."
• "That code was already used. Wait for the next code in your app."
• "That code is not right. Try the newest code in your app."
• "That backup code is not right, or it was used before."

People say: "2-step code wrong", "authenticator code doesn't work", "I lost my phone", "backup code not accepted", "it says log in again"

Why: After the right password, accounts with 2-step login ask for a code. An app code changes every 30 seconds and works once: a code that was already used, or an old code, is refused ("That code was already used. Wait for the next code in your app."). A backup code works once. Wrong codes in a row end this login attempt ("Too many wrong codes. Log in again.") and start a short wait ("Too many wrong codes. Wait {…} and try again."). If the code page stays open too long, the login ends with "Your login took too long. Log in again." "We can't check app codes right now" means app codes cannot be checked at this moment: use a backup code or try later.

Fix:

1. Open the authenticator app and wait for a fresh code. Type the newest 6-digit code for ShopPilot. If it is always wrong, set the phone's date and time to automatic.
2. "That code was already used": wait for the code to change, then type the next one.
3. No phone? Press "Use a backup code instead" and type one of the 10 backup codes you saved when you turned 2-step login on (format xxxxx-xxxxx). Each works once.
4. "Too many wrong codes. Wait {…} and try again.": wait the time shown, then type the newest code on the same page. "Too many wrong codes. Log in again." means this login attempt ended: start again at https://shoppilot.dev/login (the page also has a "Start again" link).
5. Lost the phone and all backup codes: press "Contact support" on the backup code page. Send your account email and say what you lost.
6. After you are in, open tab "Security" and make new backup codes ("New backup codes") so you always have a spare.

If still stuck: contact ShopPilot support with your account email and the exact message.

Notes: Using a backup code sends you a notice email "A backup code was used to log in". If you did not do that, change your password at once.

2-step login: turning it on or off, or making new backup codes fails

ID: account-2step-manage

Seen as:

• "Turn on 2-step login first."
• "You have no backup codes left. Make new ones."
• "Could not start 2-step login."
• "2-step login is on."
• "Backup codes copied."
• "Could not copy. Select the codes and copy them by hand."
• "2-step login is off."
• "Could not turn off 2-step login."
• "Your new backup codes are ready. The old ones no longer work."
• "Could not make new backup codes."
• "Could not load the security settings."
• "Type the 6-digit code from your app."
• "That code is not right. Type the newest code from your app."
• "This setup ended. Press Turn on to start again."
• "2-step login is already on."
• "2-step login is already off."
• "2-step login is not available right now. Please try again later."
• "Type your password."
• "Your password is not correct."
• "Type a code from your app, or a backup code."
• "That code is not right."

People say: "can't turn on 2-step", "QR code does not scan", "turn off 2-step login", "I have no backup codes left", "new backup codes"

Why: Turning on needs the app to show a matching 6-digit code. If the page is left open too long the setup ends. Turning it off needs your password and a code from the app or a backup code; making new backup codes needs a code from the app or a backup code. So a person who only has your open browser cannot change it. "You have no backup codes left. Make new ones." is a reminder to make a new set.

Fix:

1. Tab "Security", card "2-step login", press "Turn on".
2. Open an authenticator app on your phone and scan the QR code. If you cannot scan, type the key under the code ("Can't scan? Type this key in the app").
3. Type the 6-digit code the app shows now and press "Turn on 2-step login". Wait for the next code if the first is refused.
4. Save the 10 backup codes: "Copy" or "Download (.txt)". If copying fails, select the codes and copy them by hand. Press "Done" only after you saved them. They are not shown again.
5. To turn it off: "Turn off", type your password and a code (or a backup code), then "Turn off 2-step login".
6. To replace the backup codes: "New backup codes", type a code, "Make new codes". The old codes stop working.
7. If a message says it is not available right now, or the settings cannot be loaded, reload the page and try again later.

If still stuck: contact ShopPilot support with your account email and the exact message.

Notes: Turning 2-step login on or off sends a notice email to your address.

Forgot password: the reset link or the reset form does not work

ID: account-forgot-password

Seen as:

• "This password-reset form expired. Please try again."
• "Reset link unavailable · Shop Pilot"
• "This reset link doesn't work."
• "This secure password-reset form expired. Reopen the newest reset email or request another link."
• "The reset link is no longer available."
• "This password-reset link is invalid, expired, or already used."

People say: "I did not get the reset email", "reset link doesn't work", "this reset link expired", "I can't change my password"

Why: "Forgot password?" on the login page asks for your email and sends a link (subject "Reset your ShopPilot password"). The page always says "If an account uses that email, we've sent a reset link" whether or not the address has an account. The link works once and for 15 minutes. The link opens a page with a button "Reset my password"; press it to get the form with "New password", "Confirm new password" and "Save new password". An old link, a link used twice, or a form left open too long is refused. Changing your email address also cancels older reset links.

Fix:

1. On https://shoppilot.dev/login press "Forgot password?", type the account email and press "Send reset link". Use the exact email you signed up with.
2. Open the newest email "Reset your ShopPilot password" (check Spam). Press the link, then press "Reset my password" on the page that opens.
3. Type a new password of at least 12 characters twice, not containing your email name, and press "Save new password". Then log in with it.
4. "This reset link doesn't work" or "The reset link is no longer available": press "Request another link" and use only the newest email, within 15 minutes.
5. "This password-reset form expired": start again from "Forgot password?".
6. If no email arrives after a few minutes, check Spam and the spelling of the address, then ask again once.

If still stuck: contact ShopPilot support with the email address you used. Never send the new password.

Notes: Too many requests in a row are refused for a while (see Too many tries: wait and try again (sign-in, sign-up, codes, reset, password changes)). A "Your ShopPilot password was changed" email confirms the change; if you did not do it, reset the password again at once.

Change password (tab "Security") is refused

ID: account-password-change

Seen as:

• "Unable to update the password."
• "Enter your current password."
• "Enter a new password."
• "This does not match the new password."
• "Use at least 12 characters."
• "Use no more than 128 characters."
• "Your current password is not correct."
• "That is your current password. Choose a new one."

People say: "can't change my password", "current password not correct", "passwords do not match"

Why: "Change password" needs the current password, a new password of 12 to 128 characters that is different from the current one and does not contain your email name, and the same new password in "Confirm new password". "Unable to update the password." appears when the account changed at the same moment (for example the password was reset in another tab) or the account is not active.

Fix:

1. Tab "Security", card "Change password": type the current password, the new password twice, press "Change password".
2. Fix the field named in the red line and try again.
3. If you forgot the current password, log out and use "Forgot password?" on the login page.
4. After success every other session is signed out and a notice email is sent.

If still stuck: contact ShopPilot support with your account email and the exact message.

"Authorized browser limit reached"

ID: account-browser-limit

Seen as:

• "Authorized browser limit reached"
• "This account already uses all of its authorized browsers. Ask an administrator to allow one more browser or remove an old one. You do not need to sign in again: this page checks every few seconds and opens ShopPilot as soon as a browser is free."
• "This key already has {…} authorized browser device{…}. Ask the administrator to revoke or reset one."
• "This account has reached its authorized browser limit. Ask an administrator to add another browser or revoke an old one, then sign in again on this browser: a browser is only authorized while signing in."

People say: "it says browser limit", "I can't log in on my new computer", "authorized browser limit reached", "ShopPilot opens on my old PC but not here"

Why: One ShopPilot account can be used on a limited number of browsers, and a browser is added only while you sign in. Your account has reached that number, so this browser cannot be added until support makes room. The account page shows the box "Authorized browser limit reached" with a "Contact an admin" link. While it waits it says: "You do not need to sign in again: this page checks every few seconds and opens ShopPilot as soon as a browser is free."

Fix:

1. Keep the page open. When a place is free the box changes to "This browser is now authorized" and opens ShopPilot by itself.
2. Contact ShopPilot support (the box has a "Contact an admin" link). Say your account email, which browser and computer you want to use, and which old browser or computer can be removed (or ask for one more).
3. If the box shows a "Sign in again" button instead (for example after a long wait, or because you closed the page), press it and sign in again on that browser.
4. Meanwhile keep using the browser that already works.

If still stuck: contact ShopPilot support with your account email and the exact message.

Notes: This is not a password problem, so changing the password does not help. Team members have their own limit (see A teammate cannot sign in at the team sign-in page).

Connecting the ShopPilot key fails (tab "Activation Key")

ID: account-key-link

Seen as:

• "Unable to link that key. Check it and try again or contact support."
• "Unable to link that key. Wait and try again or contact support."
• "This activation key is already in use by another account."
• "This account already has an activation key. Disconnect it before linking another key."
• "Link an activation key first."
• "This key has expired."
• "That is a team member key, not a ShopPilot licence. Team members sign in at /team/login."
• "Referral code applied."
• "Enter your activation key."

People say: "my key is not accepted", "unable to link that key", "key already in use", "this key has expired", "it says I already have a key"

Why: The key goes with the email account you are logged in to. It is refused when: it has a typo; the key has ended or expired ("This key has expired."); the key is already linked to a different ShopPilot account ("This activation key is already in use by another account."); this account already holds a key ("This account already has an activation key."); or too many tries were made in a short time ("Wait and try again"). A team key (starting with SPT-) is not a licence ("That is a team member key, not a ShopPilot licence").

Fix:

1. Open the account page, tab "Activation Key". Type the key exactly as in your email (SP-XXXX-XXXX-XXXX-XXXX, capital or small letters both work), then press "Connect ShopPilot Key". Copy and paste it from the email to avoid typos.
2. "Already in use by another account": you may have another ShopPilot account (another email) with this key. Log out and log in with that email instead. If it is not yours, contact ShopPilot support.
3. "This account already has an activation key": an account holds only one key, and you cannot unlink it yourself. Contact ShopPilot support and say which key you want on this account (for example a renewal key).
4. "This key has expired": the paid time or the trial of that key ended. Renew on the "Subscription & Payments" tab (see the Billing section) or contact ShopPilot support.
5. "Wait and try again": stop for a few minutes, then try once.
6. A team key: give it to the team sign-in page https://shoppilot.dev/team/login instead.
7. "Link an activation key first": a page needs a linked key. Do step 1 first.

If still stuck: contact ShopPilot support with your account email and what the page says. Never send the full key.

Notes: After the key is linked, the tab shows only part of it ("Half of the key is hidden to protect your account"). Linking the same key again to the same account is harmless.

I lost my ShopPilot key, or I want to know what the key emails mean

ID: account-key-emails

Seen as:

• "Thank you for subscribing to ShopPilot. Your licence key is: {…} {…}Your subscription renews monthly and access extends automatically with each payment. Cancelling on Whop ends access at the close of the period you have already paid for."
• "This key is already active on your account -- just sign in: {…}/login Keep this message anyway: the key is shown only once, cannot be recovered from your account page, and is what you would need to sign in without your account."
• "Sign in and enter it here: {…}/login Keep this message: the key is shown only once and cannot be recovered from your account page."
• "Your subscription renews monthly and access extends automatically with each payment. Cancelling on Whop ends access at the close of the period you have already paid for."
• "Your 5-day Shop Pilot free trial has started. Your trial key is: {…} It is already active on your account, so in the browser you just sign in: {…}/login The Shop Pilot Bridge on your computer asks for the key once. You need the Bridge for Curate and for saving files to your computer. Download it from your account page after you sign in: {…}/dashboard Your trial's daily limits and what is left of them are shown at the top of every page in Shop Pilot. When you upgrade, the same key keeps working and everything you made stays."

People say: "I lost my key", "where is my key", "I need my key again", "I did not get my key", "the key email"

Why: A paid key is shown once, in the email "Your ShopPilot licence key" that arrives after the payment. It says the key is shown only once and cannot be recovered from your account page, so keep that email. A trial key is shown on the "Overview" tab (card "Free trial") and in the email "Your ShopPilot free trial key". When the key is already linked to your account, the email says "This key is already active on your account -- just sign in" and you do not need to type it anywhere. ShopPilot cannot show a full key again.

Fix:

1. If you can log in at https://shoppilot.dev/login and the app opens, the key is already linked. You do not need it to log in.
2. Search your mailbox (and Spam) for "Your ShopPilot licence key" or "Your ShopPilot free trial key". The email goes to the address you used at checkout on Whop, so check every mailbox you use.
3. A trial key can be copied from the "Overview" tab (button "Copy").
4. You need the full key only to pair the ShopPilot Bridge on a computer ("Access key") or to link it to a new account. If you lost it, contact ShopPilot support from your account email, say which email you paid with, and ask for help to get access again.
5. Never post the full key in a group chat, a screenshot or a public message, and never send it to support. Support never asks for your password either.

If still stuck: contact ShopPilot support with your account email and the email address used for the payment.

Notes: A key controls how long your access lasts. Your subscription renews monthly and access extends with each payment; cancelling on Whop ends access at the end of the paid period (see the Billing section).

The Etsy connect link says "OAuth session expired", "already used" or "was not found"

ID: account-oauth-link

Seen as:

• "OAuth session expired. Generate a fresh link."
• "OAuth session was not found or already expired."
• "OAuth session was already used."
• "OAuth session predates the shop-limit check. Generate a fresh link."

People say: "Etsy connect failed after I approved", "OAuth session expired", "generate a fresh link"

Why: The Etsy approval link made by "Generate OAuth Link" works once and for about 10 minutes. After Etsy sends you back, ShopPilot matches the approval to that waiting link. If the link was too old, was already used (page reload, second click, second tab), or was made before the shop limit was checked, the approval cannot be used and nothing is saved.

Fix:

1. Open "Connect Etsy" with the right shop active and press "Generate OAuth Link" again.
2. Open the new link at once in the browser that is signed in to that Etsy shop, press "Allow access" on Etsy, and do not refresh or open it twice.
3. Check that "Current Token" shows the shop as connected.
4. If it keeps failing, see the Etsy connection section of this page.

If still stuck: contact ShopPilot support with the shop name, the time and the exact message.

Notes: Nothing is saved when this fails, so trying again is safe.

Changing the account email (tab "Security") fails

ID: account-email-change

Seen as:

• "This is already your email."
• "We could not send the code. Please try again later."
• "Could not send the code."
• "Could not change the email."
• "This account can't change its email right now."
• "This email is already used by another ShopPilot account. Contact support if you want to join them."
• "That code has ended. Ask for a new one."
• "If you didn't ask for this, ignore this email. Nothing changes without the code."
• "If this wasn't you, contact support right away: {…}"
• "Type your new email."
• "Type a valid email address."
• "Type your password."
• "Your password is not correct."
• "Type the 6-digit code from the email."
• "This code has ended. Ask for a new one."
• "That code is not right."

People say: "I can't change my email", "I never got the change email code", "this email is already used by another account"

Why: Changing the email needs your password and a 6-digit code that is sent to the NEW address. The code works for 30 minutes and a few wrong tries end it. A new code replaces an older one. The change also ends if you change your password or log out of all sessions before you finish. The new address must be a normal address (no temporary inbox) and must not belong to another ShopPilot account.

Fix:

1. Tab "Security", card "Change email": type the new email and your current password, press "Send code".
2. Open the mailbox of the NEW address, find "Your code to change your ShopPilot email" (check Spam), type the 6 digits and press "Change email". The page shows "We sent a 6-digit code to ... It works for 30 minutes."
3. "This code has ended. Ask for a new one.": press "Cancel", then start again with "Send code".
4. "This is already your email": type a different address.
5. "This email is already used by another ShopPilot account": use another address, or contact ShopPilot support if both accounts are yours and you want them joined.
6. "This account can't change its email right now": the account is not in normal state (for example a deletion is scheduled). Contact ShopPilot support.
7. After the change you are signed out on your other devices, and you log in with the new email. A notice email goes out ("Your ShopPilot email was changed"). If you did not ask for the code, ignore that email: "Nothing changes without the code." If you did not change the email yourself, contact support at once.

If still stuck: contact ShopPilot support with your account email and the exact message.

"Signed-in devices" (tab "Security"): a device cannot be signed out

ID: account-devices

Seen as:

• "This device is already signed out."
• "Could not sign out that device."
• "iPhone"
• "Edge"

People say: "sign out my other computer", "unknown device in the list", "could not sign out that device"

Why: "Signed-in devices" lists the logins of your account, for example "Chrome on Windows" or "Safari on iPhone". "This device" marks the one you are using. "This device is already signed out" means the list was out of date.

Fix:

1. Tab "Security", card "Signed-in devices". Press "Sign out" next to a device you do not know.
2. If it says it could not sign out that device, reload the page and try again.
3. If you see an unknown device, also change your password (card "Change password") and press "Log out all sessions".
4. This list is about logins, not about the browser limit. For "Authorized browser limit reached" see that entry.

If still stuck: contact ShopPilot support with your account email.

Export your data ("Create secure export") does not start

ID: account-page-export

Seen as:

• "Could not create the export."
• "Type EXPORT exactly to continue."

People say: "export doesn't download", "could not create export", "I want a copy of my data"

Why: The export is a ZIP with your account details, consent records, activity, settings, listing registry and seller files. It is made on request and the download link works once and expires quickly. A very large account can be too large for one download, and asking again and again is limited.

Fix:

1. Open tab "Privacy & Data" (or "Account & Privacy" in the left menu) and press "Create secure export".
2. When the box asks, type EXPORT in capital letters and confirm. The button says "Preparing secure link…" and then "Your one-use export download started."
3. If nothing downloaded, check the browser's downloads and its pop-up/download blocker, then press the button again for a new link. A used or old link says it is invalid, expired or already used.
4. If it says the export is too large, or you asked too many times, wait a while or contact ShopPilot support for a managed transfer.

If still stuck: contact ShopPilot support with your account email and the exact message.

Notes: The ZIP can contain private seller files. Keep it safe. Security credentials are never included (the card on the tab says so).

"Disconnect all shops" (Etsy connection) fails or looks wrong

ID: account-disconnect-etsy

Seen as:

• "Not connected"
• "Etsy disconnected"
• "Could not disconnect Etsy."

People say: "I can't disconnect Etsy", "it still says connected", "disconnect one shop only"

Why: "Disconnect all shops" (tab "Overview", card "Connected shops") deletes ShopPilot's saved Etsy connections for every shop of the account. The line under it counts the stored connections ("N stored connection(s)") or says "Not connected". The button is grey when nothing is connected. It does not delete anything on Etsy, and listings stay on Etsy.

Fix:

1. Press "Disconnect all shops" and confirm ("Disconnect all Etsy shops and delete stored Etsy OAuth tokens?"). The message "Etsy disconnected" appears and the line changes to "Not connected".
2. If "Could not disconnect Etsy." appears, reload the page and try again.
3. To disconnect ONE shop only: make that shop active, open "Connect Etsy" and press "Delete Saved Token". You can also remove ShopPilot under Apps in your Etsy settings.
4. After disconnecting, the Listing Scheduler and Auto Orders stop for those shops. To connect again, use "Connect Etsy" > "Generate OAuth Link".

If still stuck: contact ShopPilot support with your account email.

Delete account (tab "Privacy & Data") and cancelling a deletion

ID: account-page-delete

Seen as:

• "account deletion is unavailable"
• "account deletion is already scheduled"
• "A request to delete your ShopPilot account was accepted. Access is disabled now and permanent deletion will occur no earlier than {…}. If delivery was delayed, the full recovery period starts when this message is delivered. If you did not request this, cancel it using this one-time link: {…} The cancellation link stops working after the deletion is completed."

People say: "delete my account", "account deletion is already scheduled", "I deleted by mistake", "can't delete my account", "how do I cancel the deletion"

Why: "Delete account" switches access off at once and schedules the deletion. During a recovery period you can cancel with the one-time link in the email "Your ShopPilot account deletion is scheduled". After the recovery period everything is deleted for good: licence keys, paired Bridge devices, stored tokens, settings, listings and files, and live account data. Etsy and other providers keep their own records. "account deletion is unavailable" means the account is not in a normal active state (for example already waiting for deletion, or the email was never confirmed). "account deletion is already scheduled" means a deletion is already waiting.

Fix:

1. Before you delete: export your data (see "Export your data"), cancel your subscription on the "Subscription & Payments" tab ("Cancel subscription", see the Billing section) and download anything you still need.
2. Tab "Privacy & Data", card "Permanently delete account": type DELETE in "Type DELETE to confirm", type your current password if it asks ("Current password (if requested)"), press "Delete account" and confirm.
3. You are logged out. The email "Your ShopPilot account deletion is scheduled" shows the earliest deletion date and time and a cancel link.
4. To cancel: open the link in that email, press "Cancel deletion and keep my account", then log in again. You get "Your ShopPilot account deletion was cancelled".
5. If the link says "Cancellation link unavailable", it was already used or the deletion is finished. If you cannot find the email, contact ShopPilot support at once, before the recovery period ends.
6. If "Could not delete the account." appears, reload the page, log in again if asked, and try once more.

If still stuck: contact ShopPilot support with your account email.

Notes: Deleting the account is permanent after the recovery period. Records that Etsy and other providers hold stay with them.

The account page or "Account & Privacy" does not load

ID: account-load

Seen as:

• "Unable to load account."

People say: "account page is empty", "could not load account", "account details won't load"

Why: The page could not get your account details at this moment: the connection dropped or your login ended.

Fix:

1. Reload the page (reload the browser tab).
2. If it still fails, log out and log in again at https://shoppilot.dev/login.
3. Try another browser (Chrome) or turn off browser extensions that block requests.

If still stuck: contact ShopPilot support with your account email, the browser and the exact message.

"This account can't open Shop Pilot right now" or "Account unavailable"

ID: account-status

Seen as:

• "This account can't open Shop Pilot right now."
• "Account unavailable."

People say: "my account is blocked", "account status", "account deletion pending", "I can log in but cannot open the app"

Why: Your login worked, but the account is not in normal state. The page "Account status" shows the state (for example "Pending verification" or "Deletion pending", or a state set by ShopPilot such as "Suspended" or "Disabled"). Common cases: the email was never confirmed; you asked to delete the account and the recovery period is still running; ShopPilot paused the account.

Fix:

1. Read the status on the page.
2. "Pending verification": confirm the email with the code (see The 6-digit email code never arrives, or the code or confirm button does not work).
3. "Deletion pending": open the cancel link in the email "Your ShopPilot account deletion is scheduled" (see Delete account (tab "Privacy & Data") and cancelling a deletion).
4. Anything else, or if you do not know why: press "Contact support" on that page and ask what the status means and what happens next.

If still stuck: contact ShopPilot support with your account email and the status shown.

Promotional email settings and unsubscribe links

ID: account-preferences

Seen as:

• "Promotional email cannot be enabled for this address. Contact support."
• "This preference form expired. Please try again."
• "This secure preference form expired. Reopen the newest email."
• "Open the unsubscribe link in a Shop Pilot email to manage promotional email."

People say: "stop the emails", "unsubscribe doesn't work", "I can't switch promotional email on", "preference form expired"

Why: Promotional email (news and offers) is optional and separate from account, security, Etsy connection, billing, invoice and legal emails, which always arrive. If an address was unsubscribed or its mail bounced before, promotional email cannot be switched on again for it. An unsubscribe link in an email works in the browser where you open it and its page expires if left open.

Fix:

1. To change it: account page, tab "Preferences", switch "Product updates and offers".
2. To stop promotional email from an email: use the unsubscribe link inside that email and press "Unsubscribe" on the page.
3. If the page says the form expired, open the newest email and use its link again.
4. "Promotional email cannot be enabled for this address. Contact support.": contact ShopPilot support from that address.

If still stuck: contact ShopPilot support with your account email.

"We updated our Terms": agree to keep using ShopPilot

ID: account-updated-terms

Seen as:

• "Updated terms · ShopPilot"
• "Tick the box to agree, then press Continue."

People say: "it asks me to agree again", "updated terms page", "I can't get into the app"

Why: When the Terms of Service or the Privacy Policy change, each account must agree to the new versions once. Until then the app does not open. The page "We updated our Terms" links both documents.

Fix:

1. Read the Terms of Service and the Privacy Policy (links on the page).
2. Tick "I agree to the updated Terms of Service and Privacy Policy" and press "Continue".
3. "Tick the box to agree, then press Continue." means the box was not ticked.
4. "This page expired. Please try again." means the page was open too long: reload it.
5. If you do not agree, press "Log out".

If still stuck: contact ShopPilot support.

Which email is this? Notices, alerts and what to do

ID: account-emails

Seen as:

• "Someone submitted the signup form using this email address. No new account was created and your password and sessions were not changed. If this was you, sign in or reset your password. If it was not you, no action is required."
• "Confirm the email address for your Shop Pilot account. Verification code: {…} Verification link: {…} Open the link or enter the code in the same browser where you created or signed in to this account. The code and link expire in 30 minutes and can be used only once. If you did not create an account, you can ignore this message."
• "A password reset was requested for your ShopPilot account. Open this link and press Reset my password to choose a new one: {…} The link expires 15 minutes after it was requested and can be used only once. If you did not request a reset, you can ignore this message."
• "If this wasn't you, reset your password now:"
• "If this was you, you don't need to do anything."
• "The scheduled deletion of your ShopPilot account was cancelled. Account access has been restored. If you did not cancel it, reset your password and contact ShopPilot support."
• "Welcome to ShopPilot! Your email is confirmed. How to start: 1. Open your account page. Start your free trial there, or pick a plan: {…}/dashboard 2. Connect your Etsy shop. 3. Install the ShopPilot Bridge app on your computer if you want to use Curate or save files to your computer. You can download it from your account page. 4. Make your first listing. Need help? Our help page: {…}/support Or write to us: {…}"
• "Your free ShopPilot trial ends tomorrow, {…}. Pick a plan to keep your shops and files: {…}/payment If you do not pick a plan, ShopPilot stops working when the trial ends. Your files are kept until {…}, then deleted. Questions? Write to {…}"
• "ShopPilot has stopped working for now. It starts again as soon as the payment goes through."
• "Your ShopPilot payment didn't go through"
• "We could not take your ShopPilot payment{…}. Please check or change your card on Whop: {…} {…} Your shops and files stay. If the payment keeps failing, Whop ends your plan. Questions? Write to {…}"
• "Your ShopPilot plan has ended, so ShopPilot has stopped working for your account. Your shops and files: - Your Etsy shops and listings stay on Etsy. We do not change them. - Your files and settings stay saved in ShopPilot. We do not delete them when a plan ends. Want to come back? Write to {…} and we will turn your plan back on, with your shops and files. Your account page: {…}/dashboard"
• "Auto Orders needs you"
• "ShopPilot's automatic Auto Orders check found something it could not finish on its own:"
• "ShopPilot's automatic Auto Orders check found something it could not finish on its own: {…}{…} Each problem is emailed once a day while it lasts."
• "Each problem is emailed once a day while it lasts."

People say: "I got an email about a signup", "I got a password changed email", "my payment didn't go through", "ShopPilot stopped working", "Auto Orders needs you email", "my plan has ended"

Why: ShopPilot sends a few emails that need no action and a few that do:

• "A signup was attempted for your ShopPilot account": someone used your address on the sign-up form. No new account was made and your password and logins did not change. If it was you, log in or use "Forgot password?". If it was not you, nothing is needed.
• "Confirm your email" and "Reset your ShopPilot password": the code or link works once, for 30 minutes (confirm) or 15 minutes (reset). Ignore them if you did not ask.
• "Your ShopPilot password was changed": "If this was you, you don't need to do anything." "If this wasn't you, reset your password now" with "Forgot password?".
• "Welcome to ShopPilot" and "Your free trial ends tomorrow": reminders with links to the account page.
• "Your ShopPilot payment didn't go through": the card was refused. ShopPilot stops working for now and starts again as soon as the payment goes through. Open the Whop link in the email, check or change the card, and pay again. Your shops and files stay. If the payment keeps failing, Whop ends the plan.
• "Your ShopPilot plan has ended": ShopPilot stopped working for the account. Your Etsy shops and listings stay on Etsy and are not changed, and your files and settings stay saved in ShopPilot. To come back, subscribe again (https://shoppilot.dev/pricing) or write to ShopPilot support to turn the plan back on.
• "Auto Orders needs you": the automatic Auto Orders check found something it could not finish on its own; the email names it. Open "Auto Orders" and follow the problem named (see the Auto Orders section). Each problem is emailed once a day while it lasts.

Fix:

1. Check the sender and the subject against this list. ShopPilot never asks for your password or full key in an email.
2. For a payment email, use the Whop link in the email, not a link someone sent you elsewhere.
3. If an email says something happened that you did not do (password changed, email changed, 2-step turned off, a backup code used), reset your password at once and contact ShopPilot support.
4. If you expected an email and it is missing, check Spam and the spelling of your account email.

If still stuck: contact ShopPilot support with your account email and the subject of the email.

"Change your shops" is not available, or shows a waiting message

ID: account-plan-change

Seen as:

• "Pick the shops to remove."

People say: "I can't change the number of shops", "Pick the shops to remove", "change your shops says wait"

Why: The "Change your shops" card on the "Subscription & Payments" tab is on every account page. It works for a card subscription on Whop; for other plans (cash, free access, a trial) it says why it cannot be used. Only the account owner sees it: team members cannot open the account page. When you remove shops below the number connected, "Pick the shops to remove." asks you to tick the shops that stop working. Quotes and starts are limited when pressed many times in a row.

Fix:

1. If the card says your plan cannot be changed here, follow its sentence or contact ShopPilot support and say how many shops you want.
2. If you are a team member, ask the shop owner.
3. If a message says to wait, wait the time given and try once. See the Billing section for how plan changes and payments work.

If still stuck: contact ShopPilot support with your account email and the number of shops you want.

A window says "Free trial limits are over"

ID: account-trial-limit-window

Seen as:

• "Free trial limits are over"

People say: "free trial limit reached", "trial limits are over", "it asks me to upgrade"

Why: The free trial has daily limits (some reset at midnight in your time zone) and limits for all five days. The window opens when you pass one of them. The line under the title names the limit and what is left. The limits are on https://shoppilot.dev/free-trial.

Fix:

1. Read the line under the title. If it is a daily limit, it comes back at midnight (your time).
2. Buttons that may appear: "Choose shops" (keep the shops you want on the plan), "Connect Etsy" (trials run at half limits until the Etsy shop is connected), "Upgrade for unlimited" (opens the payment page), "Close".
3. For more help with trial rules, see the free trial section.

If still stuck: contact ShopPilot support with your account email.

Uploading a PDF design: "larger than the MB limit", "was empty", "not enough time"

ID: account-pdf-upload

Seen as:

• "That PDF is larger than the {…} MB limit."
• "That PDF was empty."
• "There was not enough time to convert every PDF. Upload them in smaller batches."

People say: "my PDF won't upload", "PDF too large", "upload many PDFs at once fails"

Why: A PDF design is turned into an image from its first page. The file must not be empty and must be under the size limit shown in the message. Converting many PDFs in one upload can take longer than one request allows.

Fix:

1. "That PDF is larger than the N MB limit": export the PDF again at a lower size, or save the design as a PNG or JPG and upload that.
2. "That PDF was empty": the file has no content (the export failed or the copy is broken). Export it again.
3. "There was not enough time to convert every PDF. Upload them in smaller batches.": upload fewer PDFs at a time.
4. Only the first page of a PDF is used.

If still stuck: contact ShopPilot support with the file size and the exact message.

Notes: Uploading again is safe. Nothing is made until you run the next step.

Rare technical messages (account)

ID: account-rare

Seen as:

• "Proxy {1} is empty. Paste its address as http://user:password@host:port, or remove that row."

Why: Rare answers from pages around the account and the Etsy connection, usually after an old page was left open or the connection dropped. Nothing was changed.

Fix:

1. Reload the page and try the action once more.
2. "Proxy N is empty. Paste its address as http://user:password@host:port, or remove that row.": open "Proxies", paste the proxy address into that row or remove it, then save.

If still stuck: contact ShopPilot support with the exact message and what you pressed.

Not errors: labels and notes (account)

ID: account-not-errors

Seen as:

• "Account & Privacy"
• "Etsy connection"
• "Connect your Etsy shop"
• "Recent activity"

A trial limit is used up ("You've used today's ... free-trial ...")

ID: trial-limit-reached

Seen as:

• "You've used today's {…} free-trial {…}. They come back at midnight, or upgrade for unlimited."
• "You've used today's {1} free-trial {2}. They come back at midnight, or upgrade for unlimited."
• "You've used today's {…} free-trial {…} you get before connecting Etsy. Connect your Etsy shop for {…} more today, or upgrade for unlimited."
• "You've used today's {1} free-trial {2} you get before connecting Etsy. Connect your Etsy shop for {3} more today, or upgrade for unlimited."
• "You've used the {…} free-trial {…} you get before connecting Etsy. Connect your Etsy shop for {…} more, or upgrade for unlimited."
• "You've used the {1} free-trial {2} you get before connecting Etsy. Connect your Etsy shop for {3} more, or upgrade for unlimited."
• "You've used all {…} free-trial {…}. Upgrade for unlimited."
• "You've used all {1} free-trial {2}. Upgrade for unlimited."
• "Only {…} {…} left {…}. Choose fewer, or upgrade for unlimited."
• "Only {1} {2} left on your free trial. Choose fewer, or upgrade for unlimited."
• "Only {1} {2} left on your free trial before you connect Etsy. Choose fewer, or connect your Etsy shop for more."
• "This plan would post {…} listing{…} on {…}, but your free trial has {…} left that day. Post fewer, or upgrade for unlimited."
• "Free trial limit reached."
• "Today's {noun} are used up" (title of the limit window)
• "Your trial's {noun} are used up" (title of the limit window)

People say: "free trial limit reached", "they come back at midnight", "I used all my mockups today", "Only 2 Listings left, choose fewer", "I can't create more today"

Why: The free trial has fixed limits. A daily limit (mockup folders, Curate runs, listings, pins, orders) is used up until midnight in your own time zone. A limit for the whole trial (Curate images saved or put into sets, Bulk Edit applies) does not come back during the trial. Before your Etsy shop is connected every limit is half; the message then says so and offers the rest once you connect Etsy. "Only N ... left. Choose fewer" means this action needs more than what is left (for example more folders, collections or listings at once). "This plan would post N listings on <date>, but your free trial has N left that day" means a Listing Scheduler plan would put more listings on that day than the trial has left.

Fix:

1. Read which item the message names (mockups, Curate runs, listings, pins, orders, Curate images, Bulk Edit applies). The "Free trial" strip ("All limits") shows what is left and when it comes back.
2. Daily limit: wait until the time the message or the strip names (midnight in your time zone), or ask for less at once (fewer folders, untick some collections in "Curate collections", fewer listings per day in the "Listing Scheduler").
3. "Connect your Etsy shop for N more": open "Connect Etsy" and connect the shop. The full limit opens straight away.
4. A whole-trial limit, or you need more than the trial gives: press "Upgrade" (https://shoppilot.dev/pricing).

If still stuck: contact ShopPilot support with the exact message and your account email.

Notes: A refused action did not start, so nothing was created and nothing was counted. What you already made stays and can be downloaded. The wording of the strip and the limit window in the app is also listed under "Free trial banners: limits used up, half limits before Etsy, read-only day, choose which shops to keep".

"Preview uses today's listings" (Preview Copy on the free trial)

ID: trial-preview-listings

Seen as:

• "Your free preview is used, and each preview after it uses one of today's Create Listings. Today's are used up. More at {…}, or upgrade for unlimited."
• "This preview needs {…} of today's Create Listings (one per folder), and you have {…} {…} left. Preview fewer folders, or upgrade for unlimited."

People say: "my free preview is used", "preview costs a listing", "This preview needs 3 of today's Create Listings"

Why: On the free trial the first folder you preview with "Preview Copy" (once in the whole trial) is free. Every other previewed folder counts as one of today's Create Listings, because ShopPilot's AI writes the copy for it. ShopPilot asks before it counts. If today's listings are used up, or you picked more folders than listings are left, the preview is refused.

Fix:

1. Preview fewer folders. The message says how many listings are left today.
2. Wait until the time shown (midnight in your time zone), or connect your Etsy shop for the full daily limit, or upgrade.

Notes: Creating the listing later from the same preview does not count again. Paid plans do not have this rule.

"Connect your Etsy shop" (the trial waits for your shop)

ID: trial-needs-etsy

Seen as:

• "Your trial runs at half limits until your Etsy shop is connected"
• "Curate and Mockups work now. Connect your shop in ShopPilot (Connect Etsy) for the full limits, and for listings, Auto Orders, Bulk Edit, Prompt Lab and file uploads."
• "Listings are made in your Etsy shop. Connect it to create them on your free trial."
• "Auto Orders sends your Etsy shop's orders. Connect your shop to use it on your free trial."
• "Bulk Edit changes the listings in your Etsy shop. Connect your shop to use it on your free trial."
• "Connect your Etsy shop to use this. It opens on your free trial as soon as your shop is connected."
• "Prompt Lab opens as soon as your Etsy shop is connected. It is part of your free trial."
• "The Listing Scheduler posts to your Etsy shop. Connect it to plan listings on your free trial."
• "Uploading your own files opens as soon as your Etsy shop is connected. Until then, Mockups takes design images and Curate brings in Pinterest images."
• "PDF designs open as soon as your Etsy shop is connected. Use PNG, JPEG or WebP images until then."
• "This reads your Etsy shop, so it waits until the shop is connected. Connect it on the Connect Etsy page: it is part of your free trial."
• "Half limits until you connect Etsy"
• "Connect your Etsy shop first"

People say: "it says connect your Etsy shop to use my free trial", "Create Listings is locked", "Prompt Lab will not open", "I can't upload files", "half limits", "Auto prep failed: Connect your Etsy shop"

Why: Until your first Etsy shop is connected, the free trial works at half limits and only Curate, the Pin Picker and Mockups (design images) are open. Listings, the Listing Scheduler, Auto Orders, Bulk Edit, Prompt Lab, PDF designs, uploading your own files and anything that reads your Etsy shop wait for the shop. Each Etsy shop gets one free trial.

Fix:

1. Open "Connect Etsy", press "Generate OAuth Link", open the link in a browser signed in to your Etsy shop and approve on Etsy (see the Etsy connection section of this page).
2. When "Current Token" shows the shop as connected, reload ShopPilot. The locked pages open and the limits go to the full amount on the same trial.
3. Until then use Curate and Mockups with PNG, JPEG or WebP design images (PDF designs wait for the shop).

If still stuck: if connecting says this shop already had a trial, see "This Etsy shop has already had a ShopPilot free trial" below.

Market Research and the Shop Analyzer are not in the free trial

ID: trial-paid-only

Seen as:

• "Market Research is part of ShopPilot's paid plans, not the free trial. Upgrade to use it."
• "The Shop Analyzer is part of ShopPilot's paid plans, not the free trial. Upgrade to use it."

People say: "Market Research is locked on my trial", "Paid plans only", "Shop Analyzer not available"

Why: Market Research and the Shop Analyzer are part of every paid plan, not the free trial. They stay closed during the trial, before and after your Etsy shop is connected.

Fix:

1. Press "Upgrade" to move to a plan (https://shoppilot.dev/pricing). Your workspace carries over.
2. Everything else in the trial keeps working within its limits.

The free trial has ended (read-only day, then locked)

ID: trial-ended

Seen as:

• "Your free trial has ended. Look around and download what you need; nothing new runs. Upgrade to keep going — everything you made stays."
• "Your free trial has ended. Upgrade to keep going - your work is still here."
• "Your free trial has ended, so no Etsy shop can be connected. Upgrade to keep going - your work is still here."
• "Trial ended · Read-only today. Look around and download your work; nothing new runs. Locks at {time}."
• "Your trial ends today at {time}. After that nothing runs, orders included."
• "Read-only until {date}" (heading of the trial card on the account page)
• "Upgrade to pick up where you left off. Your shops, settings and files are kept until {date}."

People say: "my trial ended", "nothing runs any more", "read-only", "I can't connect my Etsy shop after the trial", "Your free trial has ended. Upgrade to keep going"

Why: The trial runs 5 days. After that comes one read-only day: you can look around and download, but nothing new runs and no orders go out. Then ShopPilot is locked until you upgrade. No Etsy shop can be connected once the trial has ended.

Fix:

1. To keep going press "Upgrade" (or open https://shoppilot.dev/payment) and pay for the number of shops you use. Your workspace, shops and files carry over on the same key.
2. If you are not ready, use the read-only day to download what you need.
3. If you do nothing, your files and settings are kept until the date shown on the account page (16 days after the trial ends) and then deleted.

If still stuck: contact ShopPilot support with your account email.

Notes: If you pay for fewer shops than the trial had connected, you first choose which shops to keep (see "Choose N shops to keep").

"Choose N shops to keep" after paying for fewer shops

ID: trial-choose-shops

Seen as:

• "Choose which Etsy shops to keep on your plan first."
• "Could not save your choice. Please try again."
• "Choose the shops to keep."
• "Only the account owner can choose the shops."
• "Choose which {limit} of your {count} shops to keep. Nothing runs until you do."
• "Your plan covers {limit} and you have {count} connected. Nothing runs until you choose."
• "Choose your shops first"

People say: "it asks me to choose shops", "nothing runs until I choose", "Could not save your choice", "I chose the wrong shop"

Why: You paid for fewer shops than your trial had connected. Nothing runs until you choose which shops to keep (as many as your plan includes). Only the account owner can choose; a team member cannot.

Fix:

1. Open the window "Choose N shops to keep" (also the "Choose shops" button in the "Free trial" strip). It lists your connected shops.
2. Tick the shops to keep and press "Keep these shops". The window shows what happens to the others before you confirm.
3. If it says "Could not save your choice. Please try again.", reload the page and choose again.
4. If you chose wrong, contact ShopPilot support within 16 days: the settings of the shops you let go are kept for that long.

Notes: The shops you let go lose their Etsy connection now, ShopPilot can no longer list, edit or send orders for them, and their scheduled plans are paused. Their order history stays and nothing changes on Etsy. To use more shops later, change your plan on the account page ("Subscription & Payments").

The free trial cannot be started

ID: trial-cannot-start

Seen as:

• "This account has already had its free trial."
• "This account already has a licence key, so it can't start a free trial."
• "Free trials are paused right now. Please try again later."
• "Verify your email address first."
• "Add a valid email address to your account first."
• "This email address has already had a ShopPilot free trial."
• "Free trials need a permanent email address. Temporary inboxes can't start one."
• "That email domain doesn't receive mail, so it can't start a free trial."
• "This account can’t start a free trial."
• "The free trial could not be started."
• "Too many tries. Wait a little and try again."
• "Free trials need your plain Gmail address. Gmail ignores dots, so sign up with the address typed without them."
• "You've paid for Shop Pilot with this email before. Use the activation key we emailed you, under Activation Key."

People say: "Start free trial does not work", "this account has already had its free trial", "this email already had a trial", "trial paused", "can't start a trial"

Why: A free trial can be started once for an account and an email address, and only by a new customer. The message says which rule stopped it:

• "This account has already had its free trial" or "This email address has already had a ShopPilot free trial": a trial was started before with this account or email.
• "This account already has a licence key" or "You've paid for Shop Pilot with this email before": you are already a customer. Use your key instead: account page > "Activation Key".
• "Verify your email address first" or "Add a valid email address to your account first": confirm the email with the 6-digit code first.
• "Free trials need a permanent email address" or "That email domain doesn't receive mail": use your normal mailbox (for example Gmail or Outlook) that you keep and can receive mail on, not a temporary, forwarding or alias address. If you signed up with such an address, change the account email on the account page ("Security" tab, "Change email") and try again.
• The Gmail message: sign up with your Gmail address typed without dots.
• "Free trials are paused right now": new trials are switched off for a while.
• "Too many tries. Wait a little and try again.": you pressed the button several times in a short time.

Fix:

1. Confirm your email first if it asks (account page > "Verify my email").
2. If you are already a customer, open "Activation Key" on the account page and connect your key. If you paid with this email before, use the key we emailed you.
3. If a trial was already used, choose a plan: https://shoppilot.dev/pricing.
4. "Too many tries": wait about an hour and press "Start free trial" once.
5. "Free trials are paused": try again later, or ask the team on the contact form at https://shoppilot.dev/free-trial.

If still stuck: contact ShopPilot support with your account email and the exact message.

"This Etsy shop has already had a ShopPilot free trial"

ID: trial-shop-used

Seen as:

• "This Etsy shop has already had a ShopPilot free trial. Upgrade to connect it."
• "This Etsy shop is already connected to another ShopPilot account, so it can't start a free trial. Upgrade to connect it."

People say: "my shop was refused for the trial", "this Etsy shop is already connected to another ShopPilot account", "Upgrade to connect it"

Why: Each Etsy shop gets one free trial. A shop that already had a ShopPilot trial, or that is connected to another ShopPilot account, cannot start a new trial.

Fix:

1. If the shop belongs to you and you used it on another ShopPilot account of yours, log in to that account instead.
2. Otherwise choose a plan to connect this shop: https://shoppilot.dev/pricing.

If still stuck: contact ShopPilot support with your account email and the shop name.

Notes: A trial can also be refused for a computer that already had a trial; see the Bridge section ("Free trial: this computer can't use the Bridge").

The trial's shop limit

ID: trial-shop-limit

Seen as:

• "Your free trial can connect up to {…} Etsy {…}, and {…} {…} already connected. Reconnecting one of them works; upgrade to connect a different shop."
• "Your free trial can connect up to {…} Etsy {…}, and all of them are in use. Reconnecting one of them works; upgrade to connect a different shop."
• "This licence key can connect at most {…} distinct Etsy {…}. It has already connected {…}. Reconnecting an already-authorized shop is allowed; contact an administrator to raise the shop limit."

People say: "Your free trial can connect up to 3 Etsy shops", "all of them are in use", "can't connect another shop on the trial"

Why: A free trial can connect up to 3 different Etsy shops. Reconnecting one of them always works. A different shop needs a plan. The last message ("This licence key can connect at most ...") comes from a key given by ShopPilot with its own shop limit.

Fix:

1. Reconnect one of the shops already connected, or upgrade to connect a different shop (https://shoppilot.dev/pricing).
2. For a key given by ShopPilot, contact ShopPilot support to change its shop limit.

Notes: See also "Trial or plan shop limit reached when connecting" in the Etsy connection section.

Connecting Etsy is refused because of the key or the shop

ID: trial-etsy-connect

Seen as:

• "OAuth returned an invalid shop identity."
• "The access key that started OAuth is no longer valid for this user."
• "The access key that started OAuth has been revoked."
• "The access key that started OAuth has expired."
• "OAuth returned an invalid Etsy shop identity."
• "The active profile has an invalid stored Etsy shop identity."
• "OAuth authenticated Etsy shop {…}, but this profile is already bound to Etsy shop {…}. Sign in to the profile's original Etsy shop and try again. No token or profile setting was changed."
• "Etsy shop {id} ({name}) is already connected to the '{profile}' profile on this account. Each Etsy shop belongs to exactly one profile - reconnect it from that profile, or disconnect it there first. No token or profile setting was changed."

People say: "OAuth says the access key expired", "the key that started OAuth is no longer valid", "this profile is already bound to Etsy shop", "invalid shop identity", "Etsy shop is already connected to another profile"

Why: ShopPilot checks the key and the shop when Etsy sends you back.

• "The access key that started OAuth has expired / has been revoked / is no longer valid for this user": the trial or plan ended, or the key was replaced, after you generated the link.
• "OAuth authenticated Etsy shop X, but this profile is already bound to Etsy shop Y. Sign in to the profile's original Etsy shop and try again. No token or profile setting was changed.": the browser was signed in to a different Etsy shop than the one this ShopPilot shop profile was first connected to.
• "Etsy shop ... is already connected to the '...' profile on this account": each Etsy shop belongs to exactly one shop profile in an account, and this shop is already attached to the profile named in the message. Connecting it to a second profile is refused so one shop's listings never go out under another shop's name.
• "invalid shop identity": Etsy's answer did not name a usable shop.

Fix:

1. Make sure the trial or plan is active (the account page shows it). If it ended, upgrade first.
2. Generate a new link: "Connect Etsy" > "Generate OAuth Link".
3. Open the link in a browser signed in to the Etsy shop this profile belongs to (sign out of other Etsy shops first), and approve.
4. For a different Etsy shop, create a new shop profile in "Settings" and connect that one instead.
5. For the "already connected to the ... profile" message, make the profile named in the message the active shop and connect it there. If the shop should live on another profile instead, first delete the old profile named in the message ("Settings", "Delete Shop"; its saved settings go with it), then connect the shop from the profile you want. If it still refuses, contact ShopPilot support.

If still stuck: contact ShopPilot support with the exact message, the shop profile name and the time.

Notes: Nothing is saved when this stops the connection, so trying again is safe.

Questions form on the Free trial page does not send

ID: trial-contact-form

Seen as:

• "That email address doesn't look right."
• "That Discord username doesn't look right."
• "That request is too long. Shorten the note and try again."
• "Something went wrong. Reload the page and try again."
• "You've sent a few requests already. We have them, and we'll be in touch."
• "We couldn't send your request just now. Message us on Discord or email support@shoppilot.dev instead."
• "This page has been open too long. Reload it and send the form again."
• "Something went wrong. Please"
• "Couldn't reach Shop Pilot. Check your connection and try again, or"
• "Choose how we should contact you: email or Discord."
• "Enter your email address."
• "Enter your Discord username."
• "We're getting a lot of requests right now. Message us on Discord or email support@shoppilot.dev instead."

People say: "the form on the free trial page says something went wrong", "That email address doesn't look right", "This page has been open too long"

Why: The "Questions before you start?" form checks your contact details and sends your question to the ShopPilot team. It refuses a mistyped email address or Discord username, a note that is too long, a page left open for a long time, or too many sends in a row. "Couldn't reach Shop Pilot" and "Something went wrong" mean the connection failed.

Fix:

1. Check the email address or the Discord username and shorten the note.
2. Reload the page and send the form once more.
3. If it says "We couldn't send your request just now", message the team on Discord or email support@shoppilot.dev instead.

Notes: The form does not start a trial. Start it from your account page with "Start free trial".

A link from the Alerio dashboard has expired

ID: trial-partner-link

Seen as:

• "This link has expired or was already opened in another browser."
• "Open the ad from your Alerio dashboard again. This link has expired or belongs to another browser."
• "Alerio dashboard verification is not connected yet."

People say: "the Alerio link does not work", "Open the ad from your Alerio dashboard again", "link was already opened in another browser"

Why: A link that starts from an ad in your Alerio dashboard works once, for a short time, and only in the browser that opened it. It fails when it is old, was already used, or was copied into another browser. The last message appears when the Alerio check is not available at the moment.

Fix:

1. Open the ad from your Alerio dashboard again, in the browser you will use for ShopPilot. Do not copy the link into another browser.
2. Sign up or log in in that same browser.
3. If the check is not available, try again later or contact ShopPilot support.

"Contact an administrator": trial keys given by ShopPilot

ID: trial-staff-keys

Seen as:

• "Your free trial access has expired. Contact an administrator if you need additional access."
• "Your free trial limit for {…} has been reached. Contact an administrator if you need additional access."
• "Your free trial limit has been reached. Contact an administrator if you need additional access."
• "Contact an administrator to increase or remove this limit."
• "Free-trial limit reached. You can still view and download what you already created — creating new ones is disabled until access is extended."
• "This limited free trial has expired. Contact an administrator for access."

People say: "Your free trial limit has been reached. Contact an administrator", "limited free trial has expired"

Why: These messages come from a limited key that the ShopPilot team gave you by hand, with its own limits and end date. "Administrator" means ShopPilot support. They are different from the self-started free trial, which says "Upgrade".

Fix:

1. Contact ShopPilot support and say which message you saw and which account email the key belongs to.
2. Or choose a plan: https://shoppilot.dev/pricing.

Notes: You can still view and download what you already created while a limit is reached.

The Bridge cannot be paired with a trial key

ID: trial-bridge

Seen as:

• "Free trials need the latest ShopPilot Bridge. Download it from your dashboard, then pair again."

People say: "my trial key does not work in the Bridge", "bridge too old for trial"

Why: Pairing a trial key needs the newest Bridge.

Fix:

1. Download the newest Bridge from the trial card on your account page ("Download the Bridge" / "Download the Bridge for Mac") and install it over the old one.
2. Paste your trial key again and press "Pair device".

Notes: If the Bridge says this computer was already used for a trial, see "Free trial: this computer can't use the Bridge" in the Bridge section.

Rare technical messages (free trial)

ID: trial-rare

Seen as:

• "Sign in first."

Why: "Sign in first." appears when a page asks ShopPilot for something that needs a signed-in session, for example the list of your trial shops or the pairing of the Pin Picker extension, after you were signed out or in another browser.

Fix:

1. Log in at https://shoppilot.dev/login in the same browser, reload the page and try again.
2. For the Pin Picker extension, log in in the same Chrome and create a new pairing token in Curate.

If still stuck: contact ShopPilot support with the exact message.

Not errors: labels and notes (free trial)

ID: trial-not-errors

Seen as:

• "Daily limits reset at midnight in your time zone. Your 5 days start the moment you press Start, so start when you have about an hour to connect your Etsy shop and install the Bridge. Until your Etsy shop is connected you can try Curate and Mockups at half these limits; listings, Auto Orders, Bulk Edit, Prompt Lab and file uploads open once it is, because each Etsy shop gets one free trial. Market Research and the Shop Analyzer come with a paid plan. After 5 days you get one read-only day; then ShopPilot locks until you upgrade, and your files are deleted 16 days later if you don’t."
• "Start your free trial, or enter an activation key you already have."

Card checkout is unavailable or paused

ID: billing-checkout-unavailable

Seen as:

• "Checkout is paused right now."
• "We can’t take card payments at the moment. Nothing has been charged. Email us and we’ll help you finish your order."
• "Card checkout is temporarily unavailable."
• "The card checkout provider is temporarily unavailable."
• "Card checkout is unavailable right now" (heading on the payment page)

People say: "Card checkout is unavailable right now", "We can't take card payments at the moment", "Checkout is paused", "the payment page does not open Whop"

Why: ShopPilot could not open Whop's checkout: Whop did not answer or returned an error, or card checkout is switched off for a while. Nothing was charged.

Fix:

1. Wait a few minutes, reload the payment page and press "Continue to pay" again.
2. If the page keeps saying card payments are not available, press "Email support" on the page, or pay cash: "Pay in person" under "Prefer cash?".
3. Do not pay a second time until you know the first attempt failed: look for a receipt from Whop or ShopPilot in your email, and check "Invoices" on your account page.

If still stuck: contact ShopPilot support with the time, your email and the exact message.

Notes: Opening the payment page or pressing "Continue to pay" never charges you. Money is taken only on Whop's own page.

"Payment could not be started", "Check the payment details", "The server didn't answer"

ID: billing-checkout-try-again

Seen as:

• "Payment could not be started. Please try again."
• "Check the payment details and try again."
• "We could not confirm your price just now, so nothing was started and nothing was charged. Please try again."
• "The server didn’t answer. Nothing was charged. Please try again."
• "Checkout security could not be started. Refresh the page and try again."
• "Secure checkout could not be started. Refresh the page and try again."
• "This email doesn’t look right."
• "Enter your email so we can send your access key."
• "Please accept the terms to continue."

People say: "Payment could not be started. Please try again.", "Checkout security could not be started", "This email doesn't look right", "We could not confirm your price just now"

Why: The payment page could not start the checkout and nothing was charged. Common causes: the email you typed is not a valid address, the terms box is not ticked, the page was open for a long time, the connection dropped, the browser blocks the security cookie the page needs, or ShopPilot could not confirm your price at that moment. "Check the payment details and try again." means ShopPilot refused a detail of the request, for example a Discord username that is not valid on the cash form.

Fix:

1. Check the email address on the page. If you are signed in, the page uses your account email.
2. If it says "Please accept the terms to continue.", tick "I agree to the Terms of Service and Privacy Policy" first.
3. Reload the payment page (it starts a fresh attempt) and press "Continue to pay" once.
4. For "Checkout security could not be started" or "Secure checkout could not be started": allow cookies for shoppilot.dev, use an up-to-date browser, and reload.

If still stuck: contact ShopPilot support with the exact message.

Notes: "Nothing was charged" in these messages is true: the card is only used on Whop's page.

"This checkout can't continue as it is. Reload the page and try again."

ID: billing-checkout-conflict

Seen as:

• "This checkout can't continue as it is. Reload the page and try again."

People say: "This checkout can't continue as it is", "I pressed pay twice"

Why: The checkout you pressed was already used, is still being created, or has expired (a checkout stays open for about 30 minutes). It also appears when something blocks a new checkout, for example an active subscription already pays for the account, or a payment for the same account is already pending. The detailed reasons are only in ShopPilot's records; the page shows this one sentence.

Fix:

1. Reload the payment page. That starts a fresh checkout. Do not reuse an old Whop checkout tab.
2. If you already pay for a subscription, do not buy again: manage it on your account page ("Subscription & Payments": change shops, change the card, cancel).
3. If you paid and cannot see your plan, check your email for the key and the receipt, then contact ShopPilot support before paying again.

If still stuck: contact ShopPilot support with your account email and the time.

"Too many payment attempts" or "Too many checkout attempts"

ID: billing-checkout-rate

Seen as:

• "Too many payment attempts. Please wait and try again."
• "Too many checkout attempts. Please wait and try again."

People say: "Too many payment attempts. Please wait and try again.", "Too many checkout attempts"

Why: Several checkouts were opened in a short time, or very many people were paying at that moment. ShopPilot limits this so unfinished checkouts do not pile up. The same applies to cash requests.

Fix:

1. Finish the checkout that is already open on Whop, or wait about 15 minutes.
2. Then reload the payment page and press "Continue to pay" once.

If still stuck: contact ShopPilot support.

The price or plan does not load

ID: billing-price-not-loading

Seen as:

• "We could not load the price just now. Please refresh the page."
• "This plan is unavailable."
• "We could not load this plan" (heading on the payment page)

People say: "We could not load the price just now", "This plan is unavailable", "We could not load this plan"

Why: The price for the chosen number of shops could not be loaded at that moment, for example because the connection dropped. If the box says "Check the payment details and try again.", ShopPilot refused the plan or the shop count in the link. The payment page takes 1 to 100 shops; a link with another number is set to the nearest of those.

Fix:

1. Refresh the page.
2. Press "Change" next to the shop count and enter a whole number from 1 to 100, then "Done".
3. For more than 100 shops contact ShopPilot support.

A referral code cannot be used at checkout

ID: billing-referral-code

Seen as:

• "Enter a code first."
• "That referral code can’t be used."
• "The code can’t be checked right now."
• "Referral discounts are for new customers, and this email address or account has already paid for Shop Pilot. Remove the referral code to continue."
• "You can't use your own referral code. Remove it to continue."
• "A referral discount has already been used with this email address. Remove the referral code to continue."
• "Referral codes cannot be checked right now."
• "Referral codes cannot be checked right now. Remove the code or try again shortly."
• "{…} Check the code or remove it to continue."
• "Enter a referral code."

People say: "That referral code can't be used", "Referral discounts are for new customers", "You can't use your own referral code", "The code can't be checked right now"

Why: A referral code gives a new customer an offer on the first month. The page refuses it when: the box is empty ("Enter a code first."); the code is not active or its owner is not eligible; the code is your own; you or your email already paid for ShopPilot before; the offer was already used with this email; or the code could not be checked at that moment.

Fix:

1. Check the code (letters and digits only; spaces and dashes are removed).
2. If the page says the offer is for new customers or was already used, press "Remove" next to the code and continue without it. You cannot add a code after the first payment.
3. "Referral codes cannot be checked right now": remove the code, or try again in a few minutes.

Notes: A referral code cannot be added on top of a partner price. The offer applies to the first month only. Details: https://shoppilot.dev/terms#referral-program-terms.

"Subscription & Payments": set to end, nothing to pay

ID: billing-subscription-tab

Seen as:

• "This subscription is set to end at the close of the period you have already paid for."
• "This account does not need to pay."
• "Current subscription"
• "Next renewal"

People say: "This subscription is set to end", "This account does not need to pay", "where is my next renewal", "Resume subscription"

Why: "This subscription is set to end at the close of the period you have already paid for" means the subscription was cancelled; you keep full access until the date shown as "Access ends on", and the "Cancel subscription" button has become "Resume subscription". "This account does not need to pay" is shown for accounts whose access ShopPilot arranged without a card payment.

Fix:

1. To keep the plan, press "Resume subscription" before the end date (it opens Whop).
2. To change the card, press "Manage payment method".
3. If the buttons are greyed out, Whop could not be reached: reload in a minute.

If still stuck: contact ShopPilot support with your account email.

Notes: The plan rows on this tab ("Subscription status", "Renews every", "Amount per renewal", "Shops covered", "Renewals so far", "Next renewal") come from Whop. If the next renewal date is missing, Whop did not answer at that moment.

"Change your shops": the card says your plan cannot be changed

ID: billing-change-refused

Seen as:

• "Your plan cannot be changed here right now."
• "Link your activation key first."
• "Your access key is not active. Contact support."
• "Your plan is not a card subscription, so it is changed by the ShopPilot team. Email support@shoppilot.dev."
• "Your subscription record is incomplete. Contact support."
• "Your partner subscription is changed through support for now. Email support@shoppilot.dev."
• "Your plan is changed by the ShopPilot team. Email support@shoppilot.dev."
• "We could not reach the payment provider just now. Try again in a minute."
• "Your subscription is not active right now. Update your card on Whop first, or contact support."
• "Your subscription is not active right now (for example a payment did not go through). Update your card on Whop first, or contact support."
• "Your subscription is set to end. Resume it first, then change your shops."
• "You can change your shops after your first full payment{…}"
• "We could not read your billing period from the payment provider. Contact support."
• "Sign in again to change your plan."
• "That change was not found."

People say: "Your plan cannot be changed here right now", "Link your activation key first", "Your subscription is set to end. Resume it first", "Your subscription is not active right now", "email support to change my plan"

Why: The card "Change your shops" works only for a card subscription on Whop that is active. It explains why it cannot work:

• "Link your activation key first": no key is linked to the account. Add it under "Activation Key". "Your access key is not active. Contact support.": the key itself has ended or was switched off.
• The plan is paid in cash or arranged by ShopPilot ("changed by the ShopPilot team"): email support.
• The subscription is set to end: press "Resume subscription" first.
• The subscription is not active (for example a payment did not go through): update your card on Whop first ("Manage payment method").
• You are still on the first month of an offer that is changed through support, or before your first full payment.
• Whop did not answer, or its billing period could not be read: try again in a minute.

Fix:

1. Follow the sentence on the card (link the key, resume, or update the card).
2. If it says "Email support@shoppilot.dev", write to ShopPilot support with your account email and how many shops you want.
3. If the page says "Sign in again to change your plan.", log in again.
4. Try again in a minute for "We could not reach the payment provider just now."

If still stuck: contact ShopPilot support.

Notes: If you do not see the card, reload the page. Support can also change the number of shops for you.

"Change your shops": the number or the timing is refused

ID: billing-change-quote

Seen as:

• "Choose how many shops you want."
• "Choose when the change starts."
• "Choose between {…} and {…} shops. For more, email support@shoppilot.dev."
• "Your next payment is due within a few hours. Change your shops after it."
• "That is the number of shops you have now."
• "Your next payment already covers that many shops."
• "Removing shops starts from your next payment: you keep your shops until then. Choose "From my next payment"."
• "Removing this many shops now leaves more credit than your next payments can use. Choose "from my next payment" instead, or email support@shoppilot.dev."
• "No shops need to be removed for this change."
• "Pick shops from your own connected shops."
• "Pick exactly {…} {…} to remove."
• "You changed your plan several times this month. Email support@shoppilot.dev to change it again."
• "You already removed shops this month. To remove more, email support@shoppilot.dev, or pick a number that keeps your connected shops."
• "You already started a change. Finish it on Whop, or wait two hours and start again."
• "You already started a change. Finish it on Whop first."
• "Card payments are not available right now."
• "We could not start the payment page just now. Nothing was charged. Try again."
• "We could not start the payment page just now. Nothing was charged."
• "This shop is no longer on your plan."

People say: "That is the number of shops you have now", "Removing shops starts from your next payment", "Pick exactly 2 shops to remove", "You already started a change", "You already removed shops this month", "Your next payment is due within a few hours"

Why: The card checks the change before it sends you to Whop. Nothing is charged when it refuses.

• "That is the number of shops you have now" or "Your next payment already covers that many shops": choose a different number.
• "Removing shops starts from your next payment": removing is only "From my next payment" (you keep the shops until then); "Now" is for adding shops.
• "Pick exactly N shops to remove": when you reduce below the number of connected shops, tick the shops that stop working.
• "Your next payment is due within a few hours": change your shops after that payment.
• "You already started a change. Finish it on Whop, or wait two hours and start again": open the Whop link from the card ("Open Whop") or wait.
• "You changed your plan several times this month" and "You already removed shops this month": ShopPilot limits repeated changes; email support to make another one.
• "Card payments are not available right now" or "We could not start the payment page just now. Nothing was charged.": try again in a few minutes.
• "This shop is no longer on your plan" is the note on a Listing Scheduler plan that was paused because its shop was let go.

Fix:

1. Choose a different number, or switch the timing to "From my next payment" for removals.
2. Tick the shops to remove when the card asks.
3. Finish or wait out an open change before starting another.
4. For anything the card refuses, email ShopPilot support with your account email and the number of shops you want.

Notes: Removing a shop from the plan does not delete the Etsy shop. To bring a removed shop back, add shops again and connect it in "Connect Etsy".

Back from Whop: the change was not finished

ID: billing-change-return

Seen as:

• "That change could not be completed. Nothing changed. You can try again, or email support@shoppilot.dev."
• "That change was finished too late to apply (your plan moved on meanwhile). Nothing changed, and any payment for it will be refunded."
• "That change expired before it was confirmed. Nothing changed. You can start it again."
• "Whop is still confirming your change. Refresh this page in a minute."

People say: "That change expired", "That change was finished too late to apply", "Whop is still confirming your change"

Why: After you confirm on Whop, ShopPilot waits for Whop to confirm the new subscription. "Whop is still confirming your change" means it has not arrived yet. "Expired" means the Whop page stayed open too long (about two hours) before you confirmed. "Finished too late" means your plan moved on (for example it renewed) before the payment arrived: nothing changed, and any payment for it is given back. "Could not be completed" means nothing changed.

Fix:

1. For "still confirming": refresh the account page in a minute. The card shows the result.
2. For "expired" or "could not be completed": start the change again from "Change your shops".
3. For "finished too late": start again if you still want it. Contact ShopPilot support if you were charged and the money does not come back.

If still stuck: contact ShopPilot support with your account email and the time you paid.

Invoices: cannot open, load or save details

ID: billing-invoices

Seen as:

• "Invoice not found · ShopPilot"
• "Unable to load invoices."
• "Could not save. Try again."
• "Unable to save preference."
• "{…} is too long ({…} characters at most)."
• "Address can have {…} lines at most."
• "VAT number can only have letters, numbers, spaces, dots and dashes."

People say: "Invoice not found", "Unable to load invoices", "Could not save", "VAT number can only have letters, numbers, spaces, dots and dashes"

Why: An invoice page opens only for the account that paid it ("This invoice does not exist, or it belongs to another account"). The list can fail to load when the connection drops. The details form refuses a field that is too long, an address with too many lines, or a VAT number with other characters than letters, numbers, spaces, dots and dashes.

Fix:

1. Log in to the account that made the payment and open the "Invoices" tab, then press "View".
2. On the invoice page press "Print or save as PDF".
3. In "Details for your invoices" shorten the field the message names and press "Save". You should see "Saved."
4. Reload the tab if the list does not load.

If still stuck: contact ShopPilot support with the payment date and your account email.

Notes: Add your VAT number in these details: Whop does not share it with ShopPilot. Invoices already issued show what Whop recorded when you paid.

Cash payment problems

ID: billing-cash

Seen as:

• "No automatic charges. Nothing activates until support confirms the cash."
• "Nothing activates until support confirms the cash."

People say: "Nothing activates until support confirms the cash", "Check the payment details and try again", "pay in person"

Why: A cash request does not charge anything and does not switch the plan on. Support arranges a meeting; the plan starts when they confirm the cash. The optional Discord box accepts a Discord username only; anything else there gives "Check the payment details and try again."

Fix:

1. Fill in the email (and your Discord username if you want support to reach you there) and press "Request a cash meeting".
2. Wait for support to contact you. To pay by card instead press "Pay by card instead".
3. If you cannot reach support, use the contact details at the top of this page.

Notes: Sending several cash requests in a short time shows "Too many payment attempts".

Rare technical messages (plans and payments)

ID: billing-rare

Seen as:

• "The cash request returned an unexpected page."
• "The checkout provider returned an unexpected address."

Why: The payment page checks where ShopPilot sends you next: only to Whop's own checkout, or to ShopPilot's Support page after a cash request. These messages appear when the answer pointed somewhere else, for example because a browser extension or a network filter changed it. Nothing was charged.

Fix:

1. Reload the payment page and try again once.
2. If it repeats, turn off browser extensions that change pages, or try another browser.

If still stuck: contact ShopPilot support with the exact message.

Not errors: labels and notes (plans and payments)

ID: billing-not-errors

Seen as:

• "Prices are in EUR without VAT. Whop adds VAT at checkout where it applies."
• "Change"
• "Regular price"
• "Volume pricing"
• "Your order"
• "Connected shops"
• "Country"
• "ShopPilot {…} shop{…}"

Etsy refused the saved connection: connect the shop again

ID: etsy-connection-reconnect

Seen as:

• "Token refresh failed: Etsy has refused this shop's saved connection since {…} ({…}), so it is not asked again. Connect the shop again on the Connect Etsy page to use it."
• "Token refresh failed: Etsy has refused this shop's saved connection since {…}, so it is not asked again before {…}. Connect the shop again on the Connect Etsy page to use it now."
• "This shop's Etsy connection has expired and could not be renewed. Open Connect Etsy and connect the shop again."
• "Etsy refused this shop's sign-in, so nothing was posted. Reconnect Etsy for this shop in Settings, then resume the plan."
• "Etsy refused the shop's token. Reconnect Etsy for this shop, then resume the plan."
• "Etsy no longer accepts this shop’s connection, so ShopPilot does not contact Etsy for it. Connect it again on the Connect Etsy page, or delete the shop if it is gone."
• "Token refresh failed: HTTPError: 400 Client Error: Bad Request for url: ..." (older wording)

People say: "it says connect the shop again", "Etsy disconnected my shop", "scheduler paused, token refused", "my listings stopped posting"

Why: Etsy no longer accepts the saved connection for this shop. Common causes: the Etsy password was changed, ShopPilot was removed under Apps on Etsy, the approval was given for a different Etsy shop, or Etsy expired the connection after a long time without use. ShopPilot then stops asking Etsy with the dead connection.

Fix:

1. Make the shop named in the message active: "Manage" at the top of the sidebar, then "Activate" on that shop (team members: "Switch").
2. Open "Connect Etsy" and press "Generate OAuth Link".
3. Open the link in a browser that is signed in to that same Etsy shop (Proxy shops: the browser profile that uses this shop's proxy) and approve on Etsy within 10 minutes.
4. Check that "Current Token" on "Connect Etsy" now shows the shop as connected.
5. If a plan for this shop stopped, open "Listing Scheduler" and press "Resume" on that plan. Auto Orders picks the shop up again on its next check.

If still stuck: if Etsy shows an error on its own page, or the shop keeps disconnecting within a day, contact ShopPilot support with the shop name and the time it happened.

Notes: Reconnecting is safe. It does not change or delete any listing.

The connect link expired, was already used, or Etsy declined it

ID: etsy-connection-link-expired

Seen as:

• "This Etsy approval has expired or was already used. An approval works once and only for a few minutes, so generate a new connect link and approve it right away."
• "Etsy couldn't finish the connection (HTTP {…}). Generate a new connect link and try again."
• "Etsy didn't accept the app for this connection. Generate a new connect link and try again; if it keeps happening, contact ShopPilot support."
• "The one-time OAuth approval was declined, expired, or could not be exchanged."
• "The Etsy approval link needs to be renewed"
• "Etsy declined authorisation: {…}"
• "Etsy OAuth error: {…}"
• "Missing OAuth state or code from Etsy."
• "Missing OAuth state or code."
• "OAuth session failed."
• "Permission was not granted — click to try again."
• "OAuth session not found."
• "The Etsy connection could not be completed. Start OAuth again; if it repeats, check the selected network mode and Etsy app settings."
• "Etsy could not be connected"
• "The OAuth setup stopped safely before saving a connection."

People say: "Etsy page says error after I approve", "the link doesn't work", "it says approval expired"

Why: An Etsy approval link works once and only for about 10 minutes. It also fails if you pressed "Deny" on Etsy's page, opened the link twice, or opened it in a different browser than the one that is signed in to the shop.

Fix:

1. Go back to "Connect Etsy" for the right shop and press "Generate OAuth Link" again.
2. Open the new link right away in the browser that is signed in to that Etsy shop, and press "Allow access" on Etsy.
3. Don't refresh the Etsy page or open the link a second time.

If still stuck: if it fails three times in a row, contact ShopPilot support with the time and the exact message.

Notes: Nothing is saved when this fails, so trying again is safe.

Connecting a Proxy shop: the proxy check stops the connection

ID: etsy-connection-proxy-check

Seen as:

• "Your profile proxy could not reach Etsy"
• "The profile proxy could not connect to Etsy's OAuth endpoint. Test or replace that profile's proxy, then start OAuth again. Proxy mode did not fall back to a direct connection."
• "Etsy refused ShopPilot's connection check through this proxy. Try another proxy; if it keeps happening, contact ShopPilot support."
• "Etsy refused ShopPilot's connection check. Try again in a few minutes; if it keeps happening, contact ShopPilot support."
• "The proxy didn't work."
• "Proxy precheck failed: {…}"
• "A Proxy shop reaches Etsy only through its own proxy, so the connection was stopped before anything was saved."
• "Shop Pilot stopped the connection instead of sending the Etsy request through the server connection."
• "If you don't use a proxy, switch the shop to Direct in Settings instead."
• "The shop's proxy did not answer the check, and there is no earlier reading for it. Some proxies refuse this check on purpose."
• "Shop Pilot could not see this browser's own address."

People say: "connecting says your profile proxy could not reach Etsy", "the check page says my IP is different"

Why: The shop is set to Proxy, so ShopPilot only talks to Etsy for it through its own proxy. The connection stops when that proxy does not work, when Etsy refuses the check made through it, or when the browser that opened the link is not on that proxy. Nothing is saved when it stops.

Fix:

1. Open "Proxies", press "Test Active Profile Proxy" with this shop active, and fix the proxy if the test fails (see "A proxy test or save fails").
2. Open the link in the browser profile that uses this same shop's proxy, not your normal browser.
3. If the check page says it cannot confirm the address but you are sure the browser uses the right proxy, it offers "Continue anyway". Some proxies block this check on purpose.
4. If you don't use a proxy for this shop, set the shop to Direct in "Settings" and generate the link again.

If still stuck: if Etsy keeps refusing the check through a working proxy, try another proxy, then contact ShopPilot support.

Trial or plan shop limit reached when connecting

ID: etsy-connection-shop-limit

Seen as:

• "This trial's shop limit has been reached"
• "Shop Pilot did not save this OAuth connection because it would exceed the access key's distinct-shop allowance."
• "Ask the administrator to raise the key's shop limit before connecting a different Etsy shop."
• "Generate a fresh OAuth link after the administrator changes the limit."

People say: "can't connect another shop", "shop limit reached"

Why: Each free trial and each plan allows a set number of different Etsy shops. Connecting one more Etsy shop than the trial or plan allows is refused before anything is saved.

Fix:

1. Free trial: the trial allows up to 3 Etsy shops. Use one of the shops already connected, or upgrade.
2. Paid plan: change your plan to more shops on your account page ("Subscription & Payments"), or remove a shop you no longer use, then press "Generate OAuth Link" again.

If still stuck: contact ShopPilot support to change the number of shops on your key.

The Etsy shop that got connected is not the one I wanted

ID: etsy-connection-wrong-shop

Seen as:

• After connecting, the Etsy shop that ShopPilot names is not the one you meant.

People say: "it connected the wrong shop", "shop name mismatch", "I have two Etsy shops and it picked the other one"

Why: Etsy connects whichever Etsy shop the browser is signed in to when you approve. If that browser was signed in to another Etsy shop, the approval went to that shop. The shop profile is now tied to that Etsy shop for good: deleting its saved token does not free it, and connecting a different Etsy shop to it is refused ("... this profile is already bound to Etsy shop ...").

Fix:

1. In your browser, sign out of Etsy and sign in to the Etsy shop you want (or use the browser profile you keep for that shop).
2. In ShopPilot, open "Settings", press "+ New Shop" and make the new shop active.
3. Open "Connect Etsy", press "Generate OAuth Link" and approve on Etsy in that browser.
4. The first shop profile stays with the other Etsy shop. Keep it if you sell from that shop too, or remove it in "Settings" with "Delete Shop".

If still stuck: if connecting the right shop is then refused because of your shop limit, contact ShopPilot support with both shop names.

Notes: Each ShopPilot shop profile belongs to exactly one Etsy shop, and each Etsy shop to one shop profile.

The "Generate OAuth Link" button fails or nothing happens

ID: etsy-connection-generate-fails

Seen as:

• "Failed to generate OAuth link"
• "Could not generate the OAuth link. Check the active shop route and try again."
• "Could not start OAuth. Check the active shop route and try again."
• "Could not start the Etsy connection. Try again."
• "No active profile selected."
• "OAuth setup is already running."
• "Could not cancel. Please try again."
• "Nothing was running to cancel."
• "Failed to load OAuth status:"
• "OAuth profile no longer exists."

People say: "Generate OAuth Link doesn't work", "OAuth setup is already running"

Why: No shop is active, an earlier connection attempt is still open, the shop's routing is not set, or the page lost its connection to ShopPilot.

Fix:

1. Make the right shop active: "Manage" at the top of the sidebar, then "Activate" on that shop (team members: "Switch").
2. If it says a setup is already running, press "Cancel" on "Connect Etsy", wait a few seconds, then press "Generate OAuth Link" again.
3. Make sure the shop is set to Direct or Proxy in "Settings" (a Proxy shop also needs its proxy picked under "Bound proxy").
4. Reload the page and try again.
5. "OAuth profile no longer exists": the shop was deleted while connecting. Choose an existing shop and start again.

If still stuck: contact ShopPilot support with the exact message.

Desktop Bridge messages on Connect Etsy

ID: etsy-connection-bridge-local

Seen as:

• "Bridge is open but not paired."
• "The Bridge is open but not paired. Paste your ShopPilot access key into the Bridge, then generate the link again."
• "Open the newest ShopPilot Bridge on this computer, then try again."
• "The browser blocked the Bridge. Click the site-controls icon beside the address, open Site settings, set Local network access to Allow, reload ShopPilot, then try again."
• "The browser cannot reach the Bridge yet."

People say: "OAuth says open the Bridge"

Why: These appear only in installations where the Etsy approval returns through the ShopPilot Bridge on your computer. The Bridge must be open and paired with your key, and the browser must be allowed to reach it.

Fix:

1. Open the newest ShopPilot Bridge and paste your ShopPilot key into it if it asks.
2. If the browser blocked it: click the site-controls icon beside the address bar, open "Site settings", set "Local network access" to "Allow", reload ShopPilot.
3. Press "Generate OAuth Link" again.

If still stuck: see the Bridge section of this page.

Rare technical messages (Etsy connection)

ID: etsy-connection-rare

Seen as:

• "Invalid OAuth callback configuration."
• "The OAuth callback is unavailable. Contact ShopPilot support before continuing."
• "✗ Invalid callback configuration"
• "✗ Bound but URL missing"
• "The saved direct OAuth route is invalid. Generate a fresh link."
• "The saved OAuth route is invalid. Generate a fresh link."
• "The OAuth proxy configuration is invalid."
• "This OAuth link is no longer attached to active ShopPilot access."
• "Etsy shop lookup failed with HTTP {…}."
• "Etsy shop lookup failed: {…}."
• "Etsy shop lookup returned an invalid response."
• "Etsy shop lookup returned an invalid user_id."
• "No proxy - refusing Etsy shop lookup (Etsy would see your real IP)."
• "No proxy — refusing to refresh token (Etsy would see your real IP)."
• "Token refresh failed: {…}: {…}"
• "Etsy API credential check failed through the selected route ({…})."
• "Etsy API credential check failed with HTTP {…}."
• "Etsy token exchange returned an invalid response."
• "No proxy configured. Refusing Etsy OAuth token request."
• "OAuth cleanup failed"

Why: Rare messages from the steps of connecting: the saved link no longer fits the shop's setup, the shop's proxy is missing, or Etsy's answer about the shop could not be read. When one appears, ShopPilot stopped safely and saved nothing.

Fix:

1. Reload the page.
2. Check the shop's "Routing mode" in "Settings": "Direct", or "Proxy" with a working proxy picked under "Bound proxy".
3. Make the shop active again and press "Generate OAuth Link" once more.

If still stuck: contact ShopPilot support with the exact message, the shop name and the time.

Not errors: labels and notes (Etsy connection)

ID: etsy-connection-not-errors

Seen as:

• "Not connected yet — open the link below in this shop's browser."
• "That browser must already be signed in to the Etsy shop you intend to connect."
• ". Generate the link, then open it in the proxy-browser profile that uses this shop's proxy and is already signed in to the Etsy shop you intend to connect."
• "Connect Etsy for the <b>currently active shop profile</b>. Generate the link, then open it in the proxy-browser profile that uses this shop's proxy and is already signed in to the intended Etsy shop. Etsy returns that same browser to ShopPilot's secure HTTPS callback; the desktop Bridge is not part of this OAuth path."
• "If it repeats, expand Technical details below and compare the first error with the OAuth log."

A proxy test or save fails: what each proxy error means

ID: proxies-check-failed

Seen as:

• "Proxy required but proxy failed: {…}"
• "The proxy didn't answer in time. Check that it's online and that the address and port are right, or try another proxy."
• "The proxy refused the user name or password (HTTP 407). Check them with your proxy provider and save the proxy again."
• "The proxy refused the connection (HTTP 403). Some proxies only allow certain sites, or only your own IP address. Check its allowlist with your proxy provider."
• "The proxy refused the connection (HTTP {…}). Check it with your proxy provider."
• "Couldn't connect through the proxy. Check its address, port and password, or try another proxy."
• "Nothing answered at the proxy's address and port. Check the port number with your proxy provider."
• "The proxy didn't work. Check its address, port and password, or try another proxy."
• "The proxy's host name couldn't be found. Check the address."
• "Proxy {…}'s host name could not be found. Check the host in the address your provider gives you, then save again."
• "Proxy {1}'s host name could not be found. Check the host in the address your provider gives you, then save again."
• "The proxy's user name or password has characters a proxy connection can't carry. Use the plain letters, digits and symbols your provider gave you."
• "The secure connection through the proxy failed. Check that the proxy type (http, https or socks5) is the one your provider gave you."
• "Proxy required but proxy failed: The proxy isn't valid." (older wording)
• "The proxy didn't respond. Check that it's online and that the address and port are right, or try another proxy." (older wording)

People say: "proxy not working", "407", "proxy failed", "the scheduler stopped because of the proxy"

Why: ShopPilot tested the proxy before talking to Etsy and the test failed. The text after "Proxy required but proxy failed:" says why:

• "didn't answer in time" or "Nothing answered": the proxy is offline, or the host or port is wrong.
• "refused the user name or password (HTTP 407)": wrong user name or password, or the proxy plan expired.
• "refused the connection (HTTP 403)": the proxy only allows some sites or only your own IP address (an allowlist).
• "host name couldn't be found": the host part of the address is wrong.
• "characters a proxy connection can't carry": the password or user name has unusual characters.
• "secure connection through the proxy failed": the proxy type (http, https or socks5) is not the one the provider gave you.

Fix:

1. Open your proxy provider's dashboard and check that the proxy is active and paid, and copy its details again.
2. Open "Proxies", paste the proxy again in one of the accepted forms (host:port:user:password or http://user:password@host:port), and press "Save Shop Proxy".
3. Make the shop active and press "Test Active Profile Proxy".
4. For HTTP 403: in your provider's dashboard, switch the proxy to user name and password login (not "IP allowlist / whitelist" login), and make sure it is allowed to open all websites.
5. If you don't need a proxy for this shop, set the shop to Direct in "Settings".
6. After the proxy works, open "Listing Scheduler" and press "Resume" on any plan that stopped. Auto Orders and sales checks retry by themselves.

If still stuck: try a different proxy from your provider. If no proxy works, contact ShopPilot support with the error text (never send the proxy password in a group chat).

Notes: While the proxy fails, nothing is sent to Etsy for that shop, so nothing is half-done. Retrying after the fix is safe.

"Save failed" or "not written in a form ShopPilot can use" on the Proxies page

ID: proxies-save-format

Seen as:

• "Save failed"
• "Could not save the proxies. Please try again."
• "The proxies could not be saved. Try again."
• "The proxy was not saved. Check its URL and try again."
• "The proxy address isn't a valid proxy URL. It should look like http://user:password@host:port."
• "Proxy {…} is empty. Paste its address as http://user:password@host:port, or remove that row."
• "Invalid proxy URL."
• "Proxy URL cannot contain a path, query string, or fragment."
• "Proxy URL must include a port."
• "Proxy URL must include a supported scheme and host."
• "Private or local proxy hosts are not allowed."
• "Private, loopback, link-local, or reserved proxy addresses are not allowed."
• "The proxy host could not be resolved safely."
• "The proxy host returned an invalid DNS answer."
• "Proxy {1} is not written in a form ShopPilot can use. Write it as host:port:user:password or http://user:password@host:port (socks5:// works too)."
• "Proxy {1} is not written in a form ShopPilot can use. Write it as http://user:password@host:port (socks5:// works too). If your provider shows host:port:user:password, put it together as http://user:password@host:port."
• "Proxy {1} has an invalid URL." (older wording)

People say: "proxies won't save", "Save failed on proxies", "invalid URL"

Why: One of the rows in the "Shop Proxy List" is not a proxy address ShopPilot can use: an empty row, a missing port, extra text after the port (a path like /something), an address of your own computer or home network, or a host that does not exist. The whole list is not saved until every row is valid. ("Save failed" can also appear on "Settings" when a shop's setup can't be saved; there it usually means the shop is set to Proxy without a picked proxy, see "A Proxy shop has no proxy".)

Fix:

1. Look at each row in "Shop Proxy List". Remove empty rows (or fill them).
2. Write each proxy exactly as host:port:user:password (for example proxy.example.com:8000:myuser:mypass) or http://user:password@host:port. socks5://user:password@host:port also works.
3. Don't add anything after the port, and don't use addresses of your own computer or home network.
4. Press "Save Shop Proxy" again. If the message names a row ("Proxy 2 ..."), fix that row.
5. A bare "Save failed" names no row: check every row as in steps 1 to 3. If all rows look right, reload the page (you may have been signed out or lost the connection) and save again.

If still stuck: send support the row's format with the password replaced by *** .

Notes: Both forms in step 2 work. An older wording of the message said to use only the http:// form; that is no longer needed.

Duplicate proxy, list full, or a proxy already used by another shop

ID: proxies-duplicate-full

Seen as:

• "Proxy {…} is already in the list. Each proxy can be added only once: remove the second copy, or enter a different proxy."
• "Proxy {1} is already in the list. Each proxy can be added only once: remove the second copy, or enter a different proxy."
• "The proxy list is full."
• "This proxy is already bound to {1}. Each shop profile must use a different proxy."
• "The dedicated Market Research proxy cannot be added to the shop proxy pool. Use a different shop proxy."
• "That proxy is already in the shop proxy pool. Market Research requires a separate proxy."
• "Duplicate proxies are not allowed." (older wording)

People say: "can't add the same proxy to two shops", "proxy list is full"

Why: Each proxy can be in the list only once, and each shop must have its own proxy. The list also has a maximum size. The Market Research proxy must be different from every shop proxy.

Fix:

1. Remove the second copy of the same proxy and press "Save Shop Proxy".
2. Give each Proxy shop its own proxy. If two shops must share one connection, set one of them to Direct instead.
3. If the list is full, delete proxies you no longer use, then add the new one.

If still stuck: contact ShopPilot support if you need a larger proxy list.

A Proxy shop has no proxy, or its proxy was deleted

ID: proxies-missing-binding

Seen as:

• "This shop is set to Proxy, but it has no proxy yet. A Proxy shop reaches Etsy only through its own proxy. Add the proxy on the Proxies page, then pick it under Bound proxy in Settings. If you don't use a proxy, switch the shop to Direct."
• "“{1}” is set to Proxy, but it has no proxy yet. A Proxy shop reaches Etsy only through its own proxy. Add the proxy on the Proxies page, then pick it under Bound proxy in Settings. If you don't use a proxy, switch the shop to Direct."
• "“{1}” is set to Proxy, but it has no proxy yet. Pick its proxy under Bound proxy, or add one on the Proxies page first. If you don't use a proxy, switch the shop to Direct. Its changes save once this is done."
• "The proxy picked for “{1}” was deleted, or its address can't be used. Add a working proxy on the Proxies page, then pick it under Bound proxy in Settings. If you don't use a proxy, switch the shop to Direct."
• "Bound proxy was deleted. This profile will refuse Etsy requests until you bind a different proxy."
• "Required for real work. This profile will not talk to Etsy or fulfillment until a proxy is bound."
• "Missing proxy (deleted)"
• "That profile proxy is missing or has no URL"
• "The active profile has a bound proxy that isn't reachable. Fix or replace the proxy on that profile, or temporarily unbind it for non-Etsy work. Shop Pilot blocks real Etsy runs on an unverified proxy on purpose."
• "This profile is locked to its bound proxy. Real Etsy work refuses to run without it."
• "Bind a proxy to the active profile, then click Test Active Profile Proxy until Settings reports a valid outbound. Etsy actions stay blocked until the route passes."
• "Refusing to run — direct Etsy traffic is not allowed."
• "Bind a proxy to this profile before making it active"
• "Bind a proxy to this shop before saving it."
• "Cleared bound proxy on:"
• "Proxy missing URL"
• "The proxy picked for “{…}” was deleted, or its address can't be used. Add a working proxy on the Proxies page, then pick it under Bound proxy in Settings. If you don't use a proxy, switch the shop to Direct."
• "{…} set to Proxy, but it has no proxy yet. A Proxy shop reaches Etsy only through its own proxy. Add the proxy on the Proxies page, then pick it under Bound proxy in Settings. If you don't use a proxy, switch the shop to Direct."
• "⚠ Missing proxy (deleted)"
• "Removing it will UNBIND those profiles. They will refuse to talk to Etsy"
• "Bind a proxy to '{1}' before saving its shop setup."
• "Cleared bound proxy on: {1} — those profiles need a new binding before they can work."

People say: "it says bind a proxy", "cleared bound proxy", "can't save shop setup", "refusing to run"

Why: The shop is set to Proxy, but no working proxy is picked for it: none was chosen yet, or the proxy it used was deleted from the list. A Proxy shop never falls back to Direct, so its Etsy work stops.

Fix:

1. If you use a proxy for this shop: open "Proxies", add the proxy and press "Save Shop Proxy". Then open "Settings", choose the shop, and pick that proxy under "Bound proxy".
2. If you don't use a proxy: open "Settings", choose the shop, and set it to Direct.
3. Save the shop settings again.

Notes: "Cleared bound proxy on: ..." after saving the list means you removed a proxy that those shops were using. Pick a new proxy for each of them, or set them to Direct.

"Another Etsy shop already used this proxy's IP address": one proxy, one Etsy shop

ID: proxies-route-pin

Seen as:

• "Another Etsy shop already used this proxy's IP address"
• "Etsy approved the connection, but ShopPilot did not save it, because Etsy has already seen a different shop through this proxy's IP address."
• "That change would give '{…}' the private proxy already used by '{…}'. Each Etsy shop must use a different proxy."
• "Route pin: this shop's proxy was changed to an address another Etsy shop has used (or that could not be checked); its Etsy connection is not sent through it."

People say: "IP already used", "it says another Etsy shop already used this proxy", "I swapped proxies between shops and now it refuses"

Why: Etsy can link shops that share an IP address, so ShopPilot sends each Etsy shop through its own proxy only. Once an Etsy shop has used a proxy, that proxy never carries a different Etsy shop: not in this account, not in another account, and not after the first shop was removed.

• "Another Etsy shop already used this proxy's IP address" is shown on the page Etsy sends you back to after you approve. Etsy approved the connection, but ShopPilot did not save it.
• "That change would give ... the private proxy already used by ..." is shown in "Settings" when you pick a proxy that another shop uses.
• "Route pin: ..." is shown in a run's log when a shop's proxy was changed to one that another Etsy shop has used.
• A proxy written with a host name (for example gate.provider.com:7000:user1:pass) counts together with its user name, so the same gateway with another user name is another proxy. A proxy written as an IP address counts as one proxy whatever the user name. The one exception: when your provider sends each user name out through its own IP address, ShopPilot checks the IP address Etsy sees while you connect, and connects the shop if no other shop was seen from that address.

Fix:

1. Generating a new link with the same proxy does not help.
2. Open "Proxies", press "+ Add", paste a proxy that no other Etsy shop has ever used, and press "Save Shop Proxy".
3. Open "Settings", choose this shop and pick the new proxy under "Bound proxy". If you don't need a proxy for this shop, set "Routing mode" to "Direct" instead.
4. Open "Connect Etsy", press "Generate OAuth Link" and open the new link in the browser profile that uses the new proxy.

If still stuck: contact ShopPilot support with the shop name and the time. Never send the proxy password.

Notes: A proxy that an Etsy shop has used stays with that Etsy shop. It cannot be moved to another Etsy shop, even after the first shop is closed or removed.

Testing the proxy could not run

ID: proxies-test-could-not-run

Seen as:

• "Could not test the proxy. Please try again."
• "Could not check the proxy just now. Checking again shortly."
• "If timeouts continue, replace the proxy or try again later."

People say: "Test Active Profile Proxy does nothing"

Why: The test could not reach ShopPilot, or the proxy timed out several times in a row.

Fix:

1. Reload the page and press "Test Active Profile Proxy" again.
2. If timeouts continue, replace the proxy or try again later.

Market Research proxy problems

ID: proxies-research

Seen as:

• "Add a dedicated research proxy first."
• "The research proxy could not be verified."
• "This proxy belongs only to Market Research. It is never offered to shop profiles, cannot match a proxy in the list above, and ShopPilot never falls back to the server connection. Market Research stays blocked until one dedicated proxy is saved and verified."
• "A dedicated research proxy is required. Direct server requests are disabled."
• "A dedicated research proxy is required for daily monitoring."

People say: "Market Research asks for a proxy"

Why: Market Research uses one proxy of its own, separate from every shop proxy. It must be added and pass its check before research can run.

Fix:

1. Open "Proxies" and scroll to "Market Research Proxy".
2. Paste a proxy that no shop uses into "Proxy URL" and press "Save Market Research Proxy".
3. Press "Re-test saved proxy" to check it.

Notes: Market Research is part of ShopPilot's paid plans, not the free trial. On a free trial the "Market Research Proxy" box is hidden.

Rare technical messages (proxies)

ID: proxies-rare

Seen as:

• "Every shop proxy entry must be an object."
• "Invalid proxy identifier."
• "Invalid selected proxy."
• "Proxy list must be an array."
• "No proxy configured. Refusing to create a direct-capable session."
• "Could not verify direct WAN IP for the leak check. Refusing to trust the proxy because IP isolation cannot be proven."
• "Could not switch to that profile. Check its proxy binding in Profiles."
• "{1}: proxy problem"

Why: Internal checks of the saved proxy list. They mean the page sent something unexpected, usually after an old page was left open.

Fix:

1. Reload the page.
2. Check the "Shop Proxy List" and press "Save Shop Proxy" again.

If still stuck: contact ShopPilot support with the exact message.

Not errors: labels and notes (proxies)

ID: proxies-not-errors

Seen as:

• "A short guided setup connects the essentials your first shop needs. The first step asks how the shop reaches Etsy: Direct, with nothing extra to set up, or through a proxy of your own."
• "Direct needs nothing extra: ShopPilot talks to Etsy for this shop itself. Proxy sends this shop’s Etsy traffic through a proxy you own, which sellers with several shops use to keep them apart. You can change it later in Settings."
• "refuses to run if the proxy can't be verified"
• "If you don't use a proxy, switch the shop to Direct."
• "Image limits and Etsy defaults."

A new shop can't be created or saved

ID: shops-settings-create

Seen as:

• "Name this shop, then press Create shop. New shops start on Direct. If you use proxies, choose Proxy and pick this shop’s proxy first."
• "Name the new shop first"
• "This shop could not be saved. Try again."
• "Shop profile names cannot contain control characters."
• "This shop is not saved yet, so it can't be made active. Press Create shop to save it first. If it was deleted in another window, reload the page."
• "At least Shop 1 must remain saved."

People say: "Create shop does nothing", "can't add a new shop", "shop not saved"

Why: A new shop needs a name of its own ("New Shop" is not accepted), a routing mode, and for Proxy a picked proxy. "This shop is not saved yet" means "Activate" or a switch was pressed before "Create shop", or the shop was deleted in another window. The last shop can never be deleted.

Fix:

1. In "Settings", type a clear name in "Shop label" (plain letters and numbers, up to 80 characters).
2. Leave "Routing mode" on "Direct" unless you use a proxy for this shop. For "Proxy", add the proxy on the "Proxies" page first, then pick it under "Bound proxy".
3. Press "Create shop" and wait for "Shop setup saved and activated."
4. If it says the shop was not saved, reload the page and try again.

If still stuck: contact ShopPilot support with the exact message.

Notes: Creating a shop does nothing on Etsy. Connect it to Etsy afterwards in "Connect Etsy".

"Shop saved, but it could not be activated" or "Could not switch to that profile"

ID: shops-settings-activate

Seen as:

• "Shop saved, but it could not be activated."
• "Shop saved, but it could not be activated"
• "Shop saved, but it could not be activated. {1}"
• "Could not switch to that profile."
• "Could not switch to that profile. {1}"
• "Profile switch failed:"
• "Could not switch to that shop. Try again."
• "This profile has an invalid routing mode."
• "This shop has an invalid routing mode. Choose Direct or Proxy in Settings."
• "A shop route must be direct or proxy."
• "The proxy bound to '{…}' is missing or has no URL."
• "The selected proxy is unavailable."
• "A Proxy shop needs its own proxy to reach Etsy. Add it on the Proxies page, then pick it under Bound proxy. If you don’t use a proxy, choose Direct."
• "Proxy '{…}' is already bound to both '{…}' and '{…}'. Each shop profile must use a different proxy."
• "This proxy's IP address was already used for a different Etsy shop. Etsy can link shops that share an IP address, so ShopPilot will not connect another shop through it. Open Proxies and use a proxy no other shop has used."

People say: "the shop won't activate", "can't switch shop", "it says check its routing mode"

Why: The text after the first sentence says which of these it was:

• The shop is set to "Proxy" but has no proxy picked, or its proxy was deleted ("The selected proxy is unavailable", "missing or has no URL").
• The same proxy is picked for two shops. Each Proxy shop needs its own proxy.
• The proxy's address was already used by a different Etsy shop. ShopPilot will not send another shop's Etsy connection through it: each proxy address belongs to one shop.
• The shop is outside your paid shop slots (see "A shop is outside your paid shop slots").
• The page lost its connection to ShopPilot for a moment.

Fix:

1. Open "Settings" and choose the shop.
2. If you don't use a proxy for it, set "Routing mode" to "Direct". It saves by itself.
3. If you do use a proxy: open "Proxies", add a proxy that no other shop uses (and that no other Etsy shop has used), then pick it under "Bound proxy" in "Settings".
4. Press "Activate" again (team members: pick the shop again with "Switch").
5. If it says the connection failed, reload the page and try once more.

If still stuck: contact ShopPilot support with the exact message and the shop name.

Notes: The shop and its settings are saved even when activating fails. Nothing is sent to Etsy until the shop is active and its route works.

A shop is outside your paid shop slots

ID: shops-settings-capacity

Seen as:

• "Shop capacity exceeded"
• "This profile is outside your current subscription-backed shop slots. Its data is preserved, but it cannot be activated until capacity is restored."
• "This shop cannot be edited until shop capacity is restored"
• "Each connected shop must have an active paid slot. Buying an upgrade adds its slots immediately."
• "There is nothing to choose: your shops already fit your plan."

People say: "my shop is greyed out", "shop capacity exceeded", "I can't edit my second shop"

Why: Your plan or trial allows fewer shops than you have set up. That happens after a plan change to fewer shops, when a payment did not go through, or when a trial ends. The extra shops keep all their data, but they cannot be activated or edited until there is a free paid slot.

Fix:

1. Check your plan on your account page ("Subscription & Payments"). Plans are priced by the number of shops; see https://shoppilot.dev/pricing.
2. To keep using more shops, change to a plan with enough shops. New slots work at once.
3. Or delete a shop you no longer use in "Settings" ("Delete Shop") to free its slot.
4. After a trial, when your plan has fewer shops than you set up, ShopPilot asks which shops to keep. "There is nothing to choose" means all your shops already fit.

If still stuck: contact ShopPilot support with your account email if the slots don't match what you paid for.

A shop can't be deleted

ID: shops-settings-delete

Seen as:

• "The active shop cannot be deleted. Activate another shop first."
• "You cannot delete the active profile. Switch to another profile first."
• "Its saved setup will be removed. The active Shop 1 cannot be deleted."

People say: "can't delete the shop", "delete button missing"

Why: The active shop can't be deleted, and the last remaining shop can't be deleted either.

Fix:

1. Make another shop active first: choose it in "Settings" and press "Activate".
2. Open "Settings", choose the shop you want to remove and press "Delete Shop", then confirm.

Notes: Deleting removes the shop's saved setup in ShopPilot. It does not touch the Etsy shop or its listings. To also remove ShopPilot's access on Etsy, remove the app in your Etsy settings (Settings, then Apps).

Create Listings asks to choose a shop, or the shop no longer exists

ID: shops-settings-listing-profile

Seen as:

• "No profile selected"
• "Nav izvēlēts neviens profils"
• "No profiles found. Create a profile first."
• "The selected shop profile no longer exists."
• "The niche this run was planned for no longer exists."

People say: "Create Listings buttons are grey", "it keeps asking which profile", "Choose profile before running"

Why: "Create Listings" will not preview, draft or publish until you confirm which shop the listings are for. A run also stops when the shop or niche it was started for was deleted in the meantime.

Fix:

1. Press "Change" on the "Listing profile" strip at the top of "Create Listings" (or wait for the "Choose Listing Profile" window).
2. Click the shop. Shops that need a proxy or a paid slot are greyed out; fix them in "Settings" ("Manage Profiles").
3. If "No profiles found", create a shop in "Settings" first.
4. If the run said the shop or niche no longer exists, choose an existing shop and niche and start the run again.

Notes: Switching to another shop anywhere in the app asks for the confirmation again. This is a safety step.

A change in Settings is not saved

ID: shops-settings-autosave

Seen as:

• "ShopPilot could not be reached, so this change is not saved yet. It is tried again in a moment."
• "This change could not be saved."
• "Settings could not be read. Nothing was changed."
• "Shop settings are unavailable right now. Reload the page."
• "That shop was not found. Reload the page."
• "Could not load the settings in use. Please try again."
• "The background style could not be saved."
• "{…} must be a valid email address."

People say: "my settings don't save", "it changed back", "Settings says not saved"

Why: Settings save by themselves, so a save fails when the page can't reach ShopPilot for a moment (often during a short update), when the page is old and the shop was changed or deleted in another tab, or when a field has a value ShopPilot can't use (for example an email address that is not valid).

Fix:

1. Wait a few seconds: "could not be reached" saves are tried again by themselves.
2. Reload the page and check the value. Type it again if it was lost.
3. Fix any field that is marked (a valid email address, for example).

If still stuck: contact ShopPilot support with the exact message and which setting you changed.

The file name rule for variation photos is not valid

ID: shops-settings-filename-template

Seen as:

• "Invalid variation filename template."
• "Invalid filename template."

People say: "Fix the filename template before saving", "variation file name error"

Why: The variation file name rule tells ShopPilot how your variation photos are named. It must have exactly one {n} where the number goes (1, 2, 3...), at most 200 characters, no characters that file names can't have (\ / < > : " | ? *), and it can't end with a dot or a space.

Fix:

1. In "Settings", find the variation file name field (it says "Use {n} for 1, 2, 3...").
2. Write it with one {n}, for example design_{n} for files named design_1.png, design_2.png.
3. Leave it empty to use the default.

Save to PC or Upload to server on Create Listings fails

ID: shops-settings-save-to-pc

Seen as:

• "Bridge not connected"
• "No parent folder is selected. Open ShopPilot Bridge and choose the parent folder where these folders should be saved."
• "No parent folder selected"
• "Save to PC failed"
• "Save to PC failed:"
• "Bridge save failed"
• "Nothing saved."
• "The folder could not be chosen. Try again."
• "Upload to server failed"
• "Upload to server failed:"
• "Nothing uploaded"

People say: "Save to PC doesn't work", "Bridge not connected", "no parent folder selected", "upload to server failed"

Why: "Save to PC" (folders that are only on ShopPilot) and "Upload to server" (folders that are only on your PC) both go through the ShopPilot Bridge. They fail when the Bridge is closed or not paired, when no parent folder (the shop's listings folder) is chosen in the Bridge, when the Bridge is an old version, or when the folder has no image files ShopPilot accepts.

Fix:

1. Open the ShopPilot Bridge on this computer and make sure it is paired with your key (see the Bridge section).
2. In the Bridge, choose the parent folder where listing folders should be saved (each shop's listings folder is set in "Niches").
3. Use Google Chrome (Safari can't reach the Bridge). If Chrome asks to "Access other apps and services on this device", press "Allow".
4. Press "Refresh folders" in "Create Listings", select the folders again and press "Save to PC" or "Upload to server".
5. "Nothing uploaded": the folder has no .jpg, .png, .webp or other image files; add the images and try again.
6. "Could not save ... Update the bridge": install the newest Bridge and try again.

If still stuck: contact ShopPilot support with the folder name, Windows or Mac, and the exact message.

Notes: Trying again is safe. Save to PC never deletes the copy on your PC; ShopPilot may ask whether to remove the server copy after a successful save.

The linked folder shows "Sync issue" or "Reconnect"

ID: shops-settings-linked-folder

Seen as:

• "Sync failed"
• "Permission was lost — click to re-grant."

People say: "linked folder stopped syncing", "Sync issue", "Reconnect button"

Why: A folder linked in the browser on "Create Listings" sends new and changed images to ShopPilot. The browser forgets the permission after a restart or when the site data is cleared ("Reconnect"), and a sync fails when ShopPilot refuses a batch (for example too many or too large files at once) or the connection drops ("Sync issue"; hover over it for the reason).

Fix:

1. Click the "Reconnect" pill and allow the browser to read the folder again.
2. For "Sync issue": hover for the reason, fix it (remove very large or unsupported files), then reload the page; it syncs again.
3. Or upload the folders with "Upload folders" instead.

Settings, Auto Orders: Gelato products don't load

ID: shops-settings-gelato-catalogue

Seen as:

• "Add this shop’s Gelato API key first."
• "Could not load Gelato’s products"
• "The catalogue refresh did not finish. You can check it in Auto Orders or try again."

People say: "Load Gelato's products is greyed out", "Gelato catalogue didn't finish"

Why: Gelato's sizes and papers are loaded from the shop's own Gelato account, so the shop needs its Gelato API key first. Loading takes several minutes, and it can stop if Gelato does not answer.

Fix:

1. Add the shop's Gelato API key in Auto Orders "Settings", group "Gelato account".
2. Press "Load Gelato’s products" and keep the page open; it updates when ready.
3. If it says the refresh did not finish, press it again later, or use "Refresh Gelato catalogue" in the Auto Orders ⋯ menu.

If still stuck: check the key in your Gelato account, then contact ShopPilot support.

Copying settings to a new shop or copying Etsy settings from another shop

ID: shops-settings-copy

Seen as:

• "That shop has nothing to copy for the settings you picked."
• "{1} setting{2} would be created in this shop. Nothing has changed yet."
• "This shop already has it."
• "This shop's own country could not be read from Etsy."
• "This master has no saved {…}."
• "Each shop picks its own Etsy settings here: a master never brings them from another shop. Choose Refresh to read this shop’s own, then pick a shipping profile, a return policy and a processing profile — a run is refused without those three. Pick a production partner as well if the master says the item was made by someone else, because Etsy refuses those listings without one. The shop section is only a fallback, because each run picks a section by name for the listing it is building. Take as long as you like here; the guide waits for Next."
• "The new shop profile could not be found."
• "Etsy creates a profile together with its first rate, and will not take an "Everywhere else" rate as that first one. This profile has nothing else in it, so it has to be started in Etsy."
• "{…} of its rates could not be rebuilt: Etsy wants either a carrier or a delivery estimate on each, and these carry a carrier that is only sold from {…}. Add them in Etsy."

People say: "copy from another shop doesn't copy the shipping profile", "it says this shop already has it"

Why: "Copy Etsy settings from another shop" (in "Niches") reads both Etsy shops and lists what would be created; nothing is made until you press "Create these in this shop". "This shop already has it" means a matching setting is already there. Some things can't be copied (for example when a shop's own country can't be read from Etsy, or a production partner, which Etsy only lets you add on Etsy). A master listing never brings another shop's shipping, return or processing settings with it: each shop picks its own.

Fix:

1. In "Niches", under "This shop's Etsy settings", press "Refresh" to read this shop's own settings from Etsy.
2. If the shop has none yet, press "Copy from another shop…", pick the shop in "Copy from", tick what to copy, press "Show me what would change", then "Create these in this shop".
3. Then pick the shipping profile, return policy and processing profile for this shop and save.
4. Anything listed as "By hand" (for example a production partner, or a shipping rate Etsy will not rebuild with that carrier): add it in Etsy yourself.
5. If it asks to reconnect a shop, connect that shop again in "Connect Etsy" first.

Rare technical messages (shops and settings)

ID: shops-settings-rare

Seen as:

• "Local Bridge identity could not be verified."
• "Local listener returned an invalid Bridge proof."
• "Etsy returned an invalid receipts response."
• "This shop's Etsy connection could not be opened."
• "Nothing changed. At least one shop has to stay ticked."

Why: Rare messages. When one appears, ShopPilot stopped safely and changed nothing.

Fix:

1. Reload the page and try once more.
2. "Local Bridge identity could not be verified" or "invalid Bridge proof": download and reopen the newest ShopPilot Bridge (on "Connect Etsy"); if it keeps happening, another program on the computer uses the Bridge's port: close it or restart the computer.
3. "This shop's Etsy connection could not be opened" or "Etsy returned an invalid receipts response": check the shop in "Connect Etsy" and connect it again if it says so.
4. "Nothing changed. At least one shop has to stay ticked": tick at least one shop in that list.

If still stuck: contact ShopPilot support with the exact message and the time.

Not errors: labels and notes (shops and settings)

ID: shops-settings-not-errors

Seen as:

• "+ Empty shop 10"
• "+ Empty shop 3"
• "+ Empty shop 4"
• "+ Empty shop 5"
• "+ Empty shop 6"
• "+ Empty shop 7"
• "+ Empty shop 8"
• "+ Empty shop 9"
• "+ Empty shop {1}"
• "Check the photo limit and folder names in Settings."
• "Here is what was copied, and what you still need to set up."
• "Nothing was copied; set it up here whenever you like."
• "Nothing here yet."

"No ShopPilot Bridge answered on this computer" (the Bridge is not found)

ID: bridge-not-found

Seen as:

• "No ShopPilot Bridge answered on this computer."
• "No ShopPilot Bridge answered on this computer. Open the ShopPilot Bridge app here. Not installed yet? Download it on the Connect Etsy page (Windows or Mac), install it, open it, then try again. If the browser is holding it back, click the site-controls icon beside the address, open Site settings, set Local network access to Allow, then reload ShopPilot. The Mac Bridge needs an Apple chip (M1 or newer) and macOS 13 or newer. The first time, macOS stops it: open System Settings, then Privacy & Security, scroll down and press Open Anyway."
• "No ShopPilot Bridge answered on this computer. Open the ShopPilot Bridge app here. Not installed yet? Download it on the Connect Etsy page (Windows or Mac), install it, open it, then try again. The Mac Bridge needs an Apple chip (M1 or newer) and macOS 13 or newer. The first time, macOS stops it: open System Settings, then Privacy & Security, scroll down and press Open Anyway."
• "No ShopPilot Bridge answered on this computer. Open the ShopPilot Bridge app here. Not installed yet? Download it on the Connect Etsy page (Windows or Mac), install it, open it, then try again. {1}"
• "No ShopPilot Bridge answered on this computer. Open the ShopPilot Bridge app here. Not installed yet? Download it on the Connect Etsy page (Windows or Mac), install it, open it, then try again."
• "The ShopPilot Bridge is not open on this PC."
• "Bridge not found. Open the ShopPilot Bridge on this computer and try again."
• "Bridge not found — open the desktop app"
• "Bridge not found"
• "Bridge unavailable. Install the Shop Pilot Bridge from the OAuth tab first."
• "Bridge is not available"
• "Run and pair ShopPilotBridge.exe first."
• "Desktop Bridge not connected"
• "Desktop Bridge required"
• "The Bridge is still not connected. Open ShopPilot Bridge on this computer"
• "Bridge connected. Try again."
• "Open your ShopPilot Bridge first, then choose the folder."
• "The Bridge took too long to answer. Reopen it and try again."
• "ShopPilot could not start the Bridge check. Reload the page and try again."
• "The browser lost its connection to the Bridge."
• "The download could not start. Check that ShopPilot Bridge is open."
• "Bridge connection could not start. Try again in a moment."
• "Bridge connection request is invalid or expired. Try again."
• "This browser is offline."
• "Browser offline — reconnect to the internet"

People say: "the bridge won't connect", "it says no Bridge answered", "Bridge not found but it is open", "bridge not connected"

Why: The website could not reach the Bridge on this computer. Most likely, in this order: the Bridge is not open (or not installed) on the computer you are using; you use Safari (it can never reach the Bridge); Chrome blocked "Local network access" for shoppilot.dev; on a Mac, macOS stopped the first open or the Mac is too old (Intel Mac or older than macOS 13); the Bridge was just restarting; the computer is offline.

Fix:

1. Open the ShopPilot Bridge app on this same computer (Windows: Start menu; Mac: Applications). Not installed? Download it on "Connect Etsy" and install it.
2. Use Google Chrome, not Safari.
3. In Chrome, click the site-controls icon beside the address bar, open "Site settings", set "Local network access" to "Allow", then reload ShopPilot.
4. Mac: if the Bridge does not open, open System Settings, then Privacy & Security, scroll down and press "Open Anyway". The Mac Bridge needs an Apple chip (M1 or newer) and macOS 13 or newer.
5. Check that the Bridge window says "Connected". If it asks for a key, see "The Bridge is open but not paired".
6. Back in ShopPilot press "Refresh folders" (Create Listings) or the action again. "Check browser permission" on "Connect Etsy" tests the connection.

If still stuck: quit the Bridge completely and open it again, restart the computer, then contact ShopPilot support with: Windows or Mac (and the macOS version), the browser, the Bridge version and port shown in the Bridge window, and the exact message.

Notes: Nothing is lost when the Bridge is not found; the action simply did not start. Try again once the Bridge connects.

Safari can't reach the Bridge

ID: bridge-safari

Seen as:

• "Safari cannot reach the ShopPilot Bridge, even when the Bridge is open: Safari blocks websites from talking to apps on this computer. Open ShopPilot in Google Chrome to use the Bridge. If Chrome asks to "Access other apps and services on this device", press Allow."

People say: "Bridge works in Chrome but not Safari", "on my Mac it never connects"

Why: Safari blocks websites from talking to apps on the same computer, so it can never reach the Bridge, even when the Bridge is open.

Fix:

1. Install Google Chrome and open https://shoppilot.dev in Chrome.
2. If Chrome asks to "Access other apps and services on this device", press "Allow".

Notes: Pages that do not need the Bridge open in Safari, but folder features and anything that needs the Bridge do not. Use Chrome for ShopPilot to be safe.

The browser blocked the Bridge (Local network access)

ID: bridge-browser-blocked

Seen as:

• "The browser blocked the Bridge. Allow Local network access in this site's settings, then reload ShopPilot."
• "Browser blocked the Bridge — allow Local network access in Site settings"
• "The browser has blocked the Bridge for this site."
• "Desktop access is blocked in this site's permissions."
• "ShopPilot is blocked from opening the Bridge. Click the site-controls icon beside the address, open Site settings, set Local network access to Allow, reload, and try again."

People say: "Chrome blocked local network", "browser blocked the bridge"

Why: Chrome asks before a website may reach apps on your computer. If "Block" was chosen (or a company policy blocks it), ShopPilot can't reach the Bridge.

Fix:

1. Click the site-controls icon beside the address bar (left of shoppilot.dev).
2. Open "Site settings".
3. Set "Local network access" to "Allow" (some Chrome versions call it "Access other apps and services on this device").
4. Reload ShopPilot and try again.

If still stuck: try a normal (not incognito) Chrome window without extensions that block local connections, or ask your IT admin if the computer is managed.

The Bridge is open but not paired, or pairing fails

ID: bridge-not-paired

Seen as:

• "The Bridge is open but not paired. Paste your ShopPilot access key into the Bridge."
• "Desktop Bridge is not paired"
• "Bridge isn’t paired yet. Open the bridge and enter your SP-XXXX key."
• "Bridge is running, but it is not paired yet."
• "Bridge not paired"
• "Bridge is not paired."
• "Bridge token missing or invalid."
• "Bridge token missing or invalid"
• "Enter your ShopPilot access key first."
• "Enter your ShopPilot key first."
• "Pairing failed ({…})."
• "Register failed ({…})."
• "Bridge auth required."
• "A validated access key is required."
• "Bridge attestation is required. Refresh Shop Pilot and use the latest Bridge."
• "The paired Bridge could not be verified. Reopen or update it."
• "Too many attempts. Try again in a minute."
• "Too many bridge pairs for this key recently. Try again later."
• "This Bridge is too old to pair securely. Download the latest ShopPilot Bridge and try again."
• "This key already has {…} authorized Bridge computer{…}. Ask the administrator to revoke or reset one."

People say: "the bridge asks for a key", "Pair device fails", "not paired"

Why: The Bridge must be paired with your ShopPilot key before the website can use it. Pairing fails when the key is mistyped, expired or not active, when the Bridge is too old, when there were too many pairing tries in a short time, or when your key already has the most Bridge computers it allows.

Fix:

1. Open the Bridge, paste your full ShopPilot key (SP-XXXX-XXXX-XXXX-XXXX) into "Access key" and press "Pair device". Team members use their own team key.
2. "Too many attempts": wait a minute (or longer, as the message says) and try once.
3. "This Bridge is too old to pair securely": download the newest Bridge on "Connect Etsy", install it, then pair.
4. "This key already has ... authorized Bridge computer(s)": contact ShopPilot support to remove a computer you no longer use.
5. After pairing, reload ShopPilot.

If still stuck: contact ShopPilot support with the exact message. Never send the full key in a group chat.

Free trial: this computer can't use the Bridge

ID: bridge-trial-computer

Seen as:

• "This computer has already been used for a ShopPilot free trial. Upgrade to use the Bridge here."
• "This computer's Bridge is already paired with another ShopPilot account, so it can't be used for a free trial. Upgrade to use the Bridge here."

People say: "trial says this computer was already used", "upgrade to use the Bridge here"

Why: A free trial is one per computer. This computer was already used for a ShopPilot trial, or its Bridge is paired with another ShopPilot account.

Fix:

1. Choose a plan to use the Bridge on this computer (see https://shoppilot.dev/pricing).
2. If you think this is a mistake, contact ShopPilot support with your account email.

Mac: the Bridge won't open, or it is not supported on this Mac

ID: bridge-mac-open

Seen as:

• "The Mac Bridge needs an Apple chip (M1 or newer) and macOS 13 or newer. The first time, macOS stops it: open System Settings, then Privacy & Security, scroll down and press Open Anyway."
• "The Mac Bridge needs an Apple chip (M1 or newer) and macOS 13 or newer."
• "This first build is not notarised yet, so the very first launch needs a right-click then Open instead of a double-click. If your Mac still will not open it, go to System Settings, then Privacy & Security, scroll down and click Open Anyway. Download it from the Connect Etsy page, under Desktop Bridge."

People say: "Mac says it can't be opened", "Apple could not verify", "bridge doesn't open on my MacBook"

Why: The Mac Bridge is built for Apple-chip Macs (M1 or newer) with macOS 13 or newer. macOS stops its first open because it is not from the App Store.

Fix:

1. Check your Mac: Apple menu > About This Mac must show an Apple chip (M1, M2, M3...) and macOS 13 or newer. Intel Macs and older macOS versions can't run it; use a Windows PC or a newer Mac for Bridge features.
2. Open the Bridge once (it is stopped).
3. Open System Settings, then Privacy & Security, scroll down and press "Open Anyway", then confirm.
4. On macOS 15 right-click > Open does not work; use step 3.

Mac or Windows: the Bridge update failed

ID: bridge-update-failed

Seen as:

• "Update your ShopPilot Bridge from the Guide tab, then try again."
• "Desktop Bridge update required"
• "Update and reopen the ShopPilot Bridge from the Connect Etsy page, then try again. The older Bridge can leave the folder picker hidden behind Chrome."
• "Bridge unsupported in this build"
• "Bridge support is unavailable in this build."
• "The macOS update needs administrator approval."
• "The Bridge filename must be ShopPilotBridge.exe or a numbered browser download such as ShopPilotBridge (2).exe before updating."
• "Could not locate the running ShopPilotBridge.app bundle."
• "Update check failed ({…})."
• "Update download failed ({…})."
• "Bridge update not found."
• "Bridge build not available."
• "macOS could not stage the replacement app."

People say: "bridge update failed", "it says update the bridge", "update needs administrator approval"

Why: The Bridge updates itself when a new version comes out, and it checks each update carefully before installing it. If anything about the download does not check out, or the computer refuses (no administrator approval, the app was renamed or moved, or an older Mac can't update itself), the update stops and the old Bridge keeps running. Some features also need a newer Bridge than the one you have.

Fix:

1. Quit the Bridge.
2. On "Connect Etsy", download the newest Bridge for your computer ("Download Bridge for Windows" or "Download Bridge for Mac").
3. Windows: run the downloaded file (keep its name ShopPilotBridge.exe). Mac: drag it into Applications and replace the old one, then use "Open Anyway" if macOS asks.
4. Open it. If it asks for your key, pair it again ("Access key", "Pair device"). Then reload ShopPilot.
5. "The macOS update needs administrator approval" or Windows asks for approval: sign in with an administrator account or ask the computer's owner to approve.

If still stuck: contact ShopPilot support with the Bridge version (shown in the Bridge window), Windows or Mac, and the exact message.

Notes: A failed update never removes your folders or your pairing.

Windows: the Bridge can't start (port or permission problem)

ID: bridge-windows-start

Seen as:

• "Windows refused every bridge port ({…}) with a permissions error (WinError 10013). This normally means Hyper-V, WSL, Docker or Windows NAT has reserved those ports, not that another Bridge is running. Run 'net stop winnat' then 'net start winnat' in an admin Command Prompt and reopen the Bridge, or …"
• "Could not start local bridge on {…}: {…}"
• "Windows administrator approval is required to run ShopPilot Bridge."
• "Connected for folders. OAuth callback is unavailable; close anything using localhost:3003."
• "macOS Keychain could not protect the device token."
• "Secure Bridge token storage is unavailable on this platform."
• "Windows could not protect the device token."
• "macOS Keychain could not read the device token."
• "The Bridge device token is missing from macOS Keychain."
• "Windows could not read the saved device token."

People say: "Bridge says could not start", "WinError 10013", "OAuth callback is unavailable"

Why: The Bridge talks to the browser through a port on your own computer. Windows features such as Hyper-V, WSL, Docker or Windows NAT can reserve those ports, or a second copy of the Bridge is already running. The Bridge also stores its pairing safely with Windows or the macOS Keychain; if that storage is unavailable, it can't keep the pairing.

Fix:

1. Make sure only one Bridge is open (check the system tray or Task Manager), then reopen it.
2. Restart the computer; reserved ports are usually freed.
3. "WinError 10013": open Command Prompt as administrator, run net stop winnat, then net start winnat, and reopen the Bridge.
4. "OAuth callback is unavailable; close anything using localhost:3003": folder features still work. Close other local development tools using that port, or ignore it (connecting Etsy does not need the Bridge).
5. Keychain or device token messages: pair the Bridge again ("Change key"). On a Mac, allow Keychain access when asked.

If still stuck: contact ShopPilot support with the exact message from the Bridge window.

The Bridge has no folders, or can't open a folder

ID: bridge-folders

Seen as:

• "Bridge is connected, but no parent folder is selected."
• "Bridge is not paired or no parent folder is selected."
• "Bridge is not paired or no parent folders are selected."
• "No folders selected."
• "(no folder selected)"
• "The selected folder could not be opened."
• "The selected folder could not be saved by the Bridge."
• "The selected folder is no longer available."
• "This Bridge build cannot open the folder picker."
• "That folder is already selected."
• "That folder path could not be saved."
• "ShopPilot Bridge could not save its settings. Please try again."
• "ShopPilot Bridge could not save its settings. {…} Check that the folder is not read-only, then try again."
• "The file could not be written."
• "The folder window could not be created."
• "The folder window failed."
• "The folder window refused several folders."
• "Folder selection timed out."
• "The selected folders are no longer available."
• "The Bridge could not read {1}. Keep the Bridge open, or choose the folders again."
• "That file is no longer in its folder. Choose the folders again."
• "Folder was not found."
• "The Bridge did not return your folder list. Try again, or reopen the Bridge."
• "A folder named {1} is in more than one folder added to the ShopPilot Bridge, and this Bridge cannot pick the one in {2}. Update the ShopPilot Bridge."
• "Duplicate folder name across parent folders. Rename one copy before using this listing."
• "No supported images found."
• "That file is too large."

People say: "no folders in Create Listings", "Bridge paired but no parent folder", "folder window doesn't open", "my folders don't show"

Why: The Bridge only shows folders you added under "Parent folders". Other causes: the folder was moved, renamed or deleted on the PC; it is on a drive that is not connected; the folder window was closed or timed out; the folder is read-only; two parent folders contain a listing folder with the same name; the folder has no image files.

Fix:

1. In the Bridge window, press "Select folder" and add the folder that holds your listing folders.
2. In ShopPilot, open "Niches" and check that the shop's listings folder is the right one.
3. In "Create Listings" press "Refresh folders".
4. If the folder window does not appear, look behind Chrome for it, or update the Bridge (older Bridges opened it behind the browser).
5. "Duplicate folder name across parent folders": rename one of the two folders with the same name.
6. "No supported images found": the folder needs .jpg, .jpeg, .png or .webp images.

If still stuck: contact ShopPilot support with the folder path (with your user name removed) and the exact message.

Saving to your PC or uploading from your PC through the Bridge failed

ID: bridge-save-upload

Seen as:

• "Bridge offline - {1} saved on the server only. Start the desktop bridge to keep a local copy on your PC."
• "Bridge offline — {1} saved on the server only."
• "Bridge save failed: {1}"
• "Could not save {1}. Update the bridge and try again."
• "Open the Bridge and try again, or turn on Save to server to keep them on the server."
• "The ShopPilot Bridge is closed, so the folders cannot be saved to your PC."
• "Stopped before generating: the ShopPilot Bridge is closed and Save to server is off."
• "The Bridge could not upload the folders from your PC. Open the Bridge and try again. Nothing was planned."
• "Local bridge upload failed"
• "Local bridge upload failed."
• "Local bridge upload failed:"
• "The ShopPilot Bridge could not send {1} from {2}."
• "The ShopPilot Bridge could not send {1} from {2}: {3}."
• "Folder is too large for the bridge."
• "Empty upload."
• "Folder upload must be a zip archive."
• "A supplied folder name is invalid."
• "Folder names cannot contain path separators."
• "Missing folder name."
• "Combined extracted folders exceed the bridge safety limit."
• "Folder archive could not be installed safely: {…}.{…}"
• "The bridge could not create a safe extraction stage."
• "Zip contains duplicate file paths."
• "Zip contains too many files."
• "Zip expands beyond the bridge safety limit."
• "Zip file conflicts with an existing directory."
• "Combined folder downloads exceed the bridge safety limit."
• "Download failed: {…}"
• "Upload failed ({…})."
• "batch {…} failed after {…} attempt(s): {…}"
• "Request body is too large."

People say: "saved on the server only", "Bridge save failed", "the folders were not saved to my PC", "upload from PC failed"

Why: The Bridge was closed or lost its connection while saving, the target folder is not set or not writable, the folder is too big for one transfer, a folder with that name is in the way, or the Bridge is an older version. When saving to the PC fails, the files stay safely on ShopPilot ("saved on the server only").

Fix:

1. Open the Bridge and check it says "Connected".
2. Check that the shop's listings folder (set in "Niches") exists on this PC and is not read-only, and that there is free disk space.
3. In "Create Listings", select the folders and press "Save to PC" again (or "Upload to server" for folders that are only on your PC).
4. For very large folders, save fewer at a time.
5. Update the Bridge if the message says so.

If still stuck: contact ShopPilot support with the folder names and the exact message.

Notes: Saving again is safe; it never deletes the copy on your PC. If a folder with the same name exists, the Bridge saves a separate copy rather than overwriting.

The Bridge download button says "not available yet"

ID: bridge-download-unavailable

Seen as:

• "{1} Bridge is not available yet"
• "{1} Bridge is not available yet."
• "{1} Bridge not available yet"
• "Download status unavailable."

People say: "Mac Bridge not available", "can't download the bridge"

Why: The download for that system is being replaced with a new version, or the page could not check the downloads.

Fix:

1. Reload "Connect Etsy" after a few minutes.
2. If it still says not available, contact ShopPilot support and say Windows or Mac.

Rare technical messages (Bridge)

ID: bridge-rare

Seen as:

• "Some Bridge cache files could not be removed."
• "A local listener answered but could not prove it is the ShopPilot Bridge."
• "Something is answering on the Bridge's port but cannot prove it is the ShopPilot Bridge. Download and reopen the newest Bridge; if it keeps happening, another program has taken the port."
• "Could not reach Shop Pilot: {…}: {…}"

Why: Internal checks between the website and the Bridge. When one appears, nothing was changed.

Fix:

1. Reload ShopPilot and reopen the Bridge.
2. "Something is answering on the Bridge's port but cannot prove it is the ShopPilot Bridge": download and reopen the newest Bridge; if it keeps happening, another program on the computer uses the same port. Close it or restart the computer.

If still stuck: contact ShopPilot support with the exact message, the Bridge version and Windows or Mac.

Not errors: labels and notes (Bridge)

ID: bridge-not-errors

Seen as:

• "Already connected in the Bridge"
• "Keep the Bridge running whenever ShopPilot needs to read or save files on your computer."
• "Not connected yet — open the link below."

A run is refused: no shipping profile, return policy or processing profile for this shop

ID: master-listings-shop-settings

Seen as:

• "This niche builds from a saved master but has no shipping profile chosen for this shop. Open Niches, choose Refresh under this shop's Etsy settings, and pick one."
• "This niche builds from a saved master but has no processing profile chosen for this shop, and Etsy refuses a listing without one. Open Niches, choose Refresh under this shop's Etsy settings, pick a processing profile and save."
• "This niche builds from a saved master but has no return policy chosen for this shop. Open Niches and pick one."
• "This niche's shipping profile and return policy were chosen for a different shop, so Etsy would refuse every listing in this run. Open Niches, choose Refresh under this shop's Etsy settings, and pick them again."
• "This niche has no shipping profile chosen for this shop. Open Niches and pick one -- a saved master carries the shipping profile of the shop it came from, which cannot be used here."
• "Could not read this shop's Etsy settings."
• "The selected {…} no longer exists in this shop."
• "A saved master carries no shipping profile, return policy or processing profile of its own, so choose this shop’s and a run will not be refused. Everything here saves by itself."
• "This shop was connected before Shop Pilot could change shop settings, and Etsy will not add that to a connection it has already granted. Reconnect this shop in Settings and run the import again."

People say: "it says no shipping profile chosen for this shop", "Etsy refuses the listing", "processing profile missing", "return policy missing"

Why: A master carries no shop settings, so every shop must pick its own shipping profile, return policy and processing profile in Niches. Etsy refuses a physical listing without them, so ShopPilot stops the run before anything is sent. It also stops when the settings picked belong to a different shop (for example picked while another shop was active), or when one of them was deleted on Etsy.

Fix:

1. Make the shop you were listing for the active shop (press "Manage" at the top of the left menu, then "Activate" next to the shop; team members press "Switch").
2. Open "Niches" and choose the niche.
3. Under "This shop's Etsy settings" press "Refresh" (it reads this shop's own settings from Etsy).
4. Pick a shipping profile, a return policy and a processing profile. They save by themselves.
5. If the lists are empty, the shop has none on Etsy yet: create them in Etsy (Shop Manager > Settings) or press "Copy from another shop…" to copy them from one of your other shops, then "Refresh" again.
6. Start the run again.

If still stuck: "Reconnect this shop": the shop was connected before ShopPilot could change shop settings; connect it again in "Connect Etsy" so Etsy grants the newer permission, then try again.

Notes: Nothing was created on Etsy when this stops a run, so starting again is safe.

"Etsy refused": the master says the item was made by someone else (production partner)

ID: master-listings-production-partner

Seen as:

• "Etsy refused to create this listing. The master says the item was made by someone else, and Etsy will not accept a listing like that unless the shop names a production partner - this shop has none chosen."

People say: "you cannot sell this item on Etsy", "production partner required"

Why: The master's "who made it" says someone else made the item. Etsy refuses such a listing unless the shop names a production partner, and Etsy only lets you add production partners on Etsy itself.

Fix:

1. On Etsy, open Shop Manager > Settings > Production partners and add your print partner.
2. In ShopPilot open "Niches", press "Refresh" under "This shop's Etsy settings", pick the production partner, and start the run again.
3. Or, if you make the item yourself, change "who made it" in the master's details.

The niche has no master, or the master can't be read or isn't ready

ID: master-listings-not-ready

Seen as:

• "The saved master listing for this niche could not be read. Open Niches and re-pick it."
• "Master listing template was not found."
• "That saved master listing could not be read from your library. Open Master Listings and pick one that is still there."
• "… (your master listing library could not be read — open Master Listings)"
• "{1} has no saved master listing for {2}, so its folders can’t be checked. Each shop needs its own."
• "“{1}” is not filled in yet, so a run can't use it. {2} Open Master Listings and press Edit on it."
• "This master cannot run yet."
• "This master’s description is missing"
• "The description is missing {…}."
• "No saved masters yet."
• "Could not load the master listing library."
• "That Etsy master listing is already assigned to another shop profile. Enter this shop's own master listing ID."
• "This niche has no master listing yet. Open Niches, choose a saved master from your library, and save — every run reads its photos, category, variations and base copy from it."
• "“{1}” is not ready to run yet. {2} Open Master Listings and press Edit on it."

People say: "this niche has no master listing yet", "the master is not ready to run", "description is missing INTRO"

Why: Every run builds from a saved master chosen on the niche for this shop. The run stops when no master is chosen, the chosen master was removed from the library, it was never filled in (a blank master), or it is not ready: no photos or no Etsy category yet.

Fix:

1. Open "Niches", choose the niche, and press "Choose" under "Saved master listing". Pick a master. If your library is empty, make one in "Master Listings" first: "Add from Etsy", "Use phone case built-in master" or "New blank master". Everything on "Niches" saves by itself; there is no save button.
2. To fix a master: open "Master Listings", press "Edit" on it. Upload your own photo into each slot on "Photos".
3. Press "Save master listing" and check that the card says "Ready to run".
4. Each shop needs its own choice on the niche: make the other shop active and choose the master there too.
5. "That Etsy master listing is already assigned to another shop profile": use this shop's own listing, or choose a saved master from the library instead.

A listing folder doesn't match the master's photo file names

ID: master-listings-photo-filenames

Seen as:

• "Two photos cannot share the filename "{…}" -- a run could not tell which slot the folder's file belongs to."
• "Every listing folder needs a file with this name"
• "Cannot carry a variation photo."
• "This master has no variations, so photos cannot be attached to one.</span>"
• "This master has no variations, so photos cannot be attached to one."
• "Image {…} cannot carry a variation photo. It was added outside the Etsy import, so Etsy has no ID for it."
• "The master has {…} images, but this shop's configured Etsy image limit is {…}."
• "Everything here saves by itself as soon as you change it. Every listing folder must hold a file for each of the master's photo filenames; those files fill its gallery slots. Anything else in the folder stays behind."

People say: "filename mismatch", "folder refused, file missing", "two photos cannot share the filename"

Why: A run fills each master photo slot with the folder's file of the same name. A folder missing a file the master names is refused before anything is sent to Etsy, and the message names the file. Two slots can't have the same file name, because a run could not tell which file goes where. A variation photo can only link to a photo that came with an Etsy import, and only when the master has variations. A master can't have more photos than the shop's image limit.

Fix:

1. Open "Master Listings" > "Edit" > "Photos" and read the file name under each slot.
2. Rename the files in your listing folders to match (capital letters don't matter; .png and .jpg count as the same name), or upload one of your own files into each slot so the master records your names.
3. Give every slot a different file name.
4. Folders made with "Create Mockups" already match the generator's names.
5. "this shop's configured Etsy image limit": remove photo slots, or raise the image limit in "Settings".

Notes: Extra files in a folder are fine; anything the master does not name stays behind, and numbered design files such as 1.png are ignored.

Master photos: upload or remove fails

ID: master-listings-photo-upload

Seen as:

• "The photo must be a jpg, jpeg, png, webp or gif file."
• "The photo's filename cannot start or end with a dot or space."
• "The photo's filename contains characters a listing folder cannot hold."
• "The photo's filename must be 1-180 characters."
• "The photo must be a jpg, png, webp or gif image."
• "That is an iPhone HEIC photo. Upload a JPG or PNG copy of it instead."
  LV: "Tas ir iPhone HEIC foto. Augšupielādējiet tā JPG vai PNG kopiju."
  RU: "Это фото iPhone в формате HEIC. Загрузите вместо него копию в JPG или PNG."
• "The photo's dimensions are too large to store safely."
• "The uploaded photo is empty."
• "Could not upload that photo."
• "Could not add that photo."
• "Could not remove that photo."
• "The master listing image set is too large."
• "The master’s {1} photo could not be read."
• "A photo of that master is missing, so it could not be copied."
• "This master listing's gallery order is incomplete and cannot be edited. Re-import it from Etsy."

People say: "can't upload a photo to the master", "photo too large"

Why: Master photos must be jpg, jpeg, png, webp or gif images with a file name of 1 to 180 characters that a folder can hold (no \ / : * ? " < > |, not starting or ending with a dot or space). Very large pictures or a too-large photo set are refused. An old imported master with an incomplete gallery order can't be edited.

Fix:

1. Save the photo as JPG or PNG with a simple name (letters, numbers, - and _).
2. Make very large pictures smaller (for example under 4000 px on the long side) and upload again.
3. "gallery order is incomplete": add the listing again with "Add from Etsy".
4. "A photo of that master is missing": open the master, upload the missing photo, then copy again.

Niche setup: a field is not valid, or the niche can't be saved

ID: master-listings-niche-setup

Seen as:

• "{…} is required."
• "{…} must be a filename, not a path."
• "{…} must contain one {n} placeholder."
• "{…} must end with a supported image extension."
• "The variation filename template cannot end with a dot or space."
• "The variation filename template contains a character that filenames cannot use."
• "The variation filename template must be 200 characters or fewer."
• "Choose this shop's listings folder first."
• "Could not save niche setup"
• "Could not save the folder and master. Check both and try again."
• "Could not save this niche."
• "Could not save niche setup."
• "Listings folder location is invalid or too long."
• "Could not open the folder picker."
• "No folder was selected."
• "Could not analyze folder"
• "ShopPilot could not analyze that folder."

People say: "Could not save niche setup", "listings folder required", "must contain one {n}"

Why: A niche needs this shop's listings folder and a valid setup. A file name rule must be a file name (not a folder path), end with an image extension (.png, .jpg...), and have exactly one {n} where the number goes. The folder path must be a real, not too long path on the computer running the Bridge. Saves also fail when the page lost its connection.

Fix:

1. Under "This shop's listings folder" press "Choose in Explorer" (the Bridge must be open) or paste the full folder path.
2. Fix the field the message names (for example design_{n}.png).
3. If the folder picker does not open, open the Bridge and try again, or update the Bridge.
4. Reload the page if saving keeps failing.

Adding, switching or deleting a niche fails

ID: master-listings-niche-manage

Seen as:

• "Type the product type in the box first, for example Wall Art, then press Add niche."
• "That niche already exists."
• "Could not create niche"
• "Could not delete niche"
• "Phone Cases is the built-in default and cannot be deleted."
• "Could not switch niche"
• "Niche not found."
• "Could not load niche profiles. Using Phone Cases for now."
• "Could not load niches"
• "loadNiches failed"
• "Could not save preference"
• "Could not save the niche guide preference"

People say: "can't add a niche", "can't delete Phone Cases"

Why: The product type box was empty, the niche already exists, the page lost its connection, or the niche was deleted in another tab. Phone Cases is the built-in niche and can't be deleted.

Fix:

1. Type the product type only (for example Wall Art) and press "Add niche".
2. Reload the page and try again.

Notes: Deleting a niche does not delete anything on Etsy or your PC.

"Add from Etsy" fails

ID: master-listings-import

Seen as:

• "The Etsy master listing needs at least one gallery image."
• "Etsy could not be reached over this shop's network route."
• "Etsy returned an unreadable response."
• "The Etsy master listing needs at least one image."
• "An Etsy image could not be saved."
• "Etsy returned an invalid image rank."
• "Etsy returned an unsupported image format."
• "The Etsy master listing data is too large to save safely."
• "The master listing library is limited to {…} templates."
• "An Etsy image could not be downloaded over this shop's network route."
• "Etsy returned an empty master image."
• "Etsy returned an unsupported master image format."
• "Etsy returned too many master image redirects."
• "Etsy returned an invalid master image URL."
• "Could not save that Etsy listing as a master."
• "Reading another shop is not available here."
• "That shop's route is unavailable."
• "Select a shop profile first."
• "The selected shop route is unavailable."
• "The active Etsy shop ID is invalid."

People say: "Add from Etsy doesn't work", "master listing needs at least one image"

Why: ShopPilot copies the listing from Etsy through the active shop's connection. It fails when the listing has no photos, Etsy could not be reached on the shop's route (a proxy problem or Etsy busy), Etsy sent a photo ShopPilot can't use, the listing belongs to another shop, or the library is full.

Fix:

1. Make the shop that owns the listing active, and use the listing's number from its Etsy link.
2. Make sure the listing has at least one photo on Etsy.
3. If it says Etsy could not be reached, check the shop's route (Proxies section) and try again later.
4. Library full: remove masters you no longer use.
5. Or start with "New blank master" or "Use phone case built-in master" and upload your own photos.

Master editor: a detail, price or variation can't be saved

ID: master-listings-editor

Seen as:

• "Listing title cannot be blank."
• "Template name cannot be blank."
• "Price and quantity must be valid numbers."
• "Price must be greater than zero."
• "Quantity must be between 1 and 999."
• "Price must be a valid number."
• "Quantity must be a whole number."
• "Set a price for this master first."
• "The quantity for "{…}" must be between 1 and 999."
• "The price for "{…}" must be greater than zero."
• "A price for each combination needs exactly two variations."
• "Every variation property needs a name."
• "{…} needs at least one value."
• "Etsy allows {1} models on one variation. Remove one first, then add the new model."
• "A personalization question has an invalid limit or option list."
• "A personalization question has an unsupported type."
• "Pick an Etsy category first."
• "Could not save this master listing."
• "could not be saved."
• "Could not save the master listing."
• "Could not load this master listing."
• "Could not load categories."
• "Could not load this category’s options."
• "Could not save the category."
• "Could not add the starter master."
• "Could not create a blank master."
• "Could not copy the master listing."
• "That master is too large to copy safely."
• "Could not remove the master listing."
• "Could not load master listings."
• "Could not prepare this master listing."

People say: "Could not save this master listing", "price must be greater than zero"

Why: Etsy's rules apply to the master: a title and a name, a price above zero, a quantity from 1 to 999, every variation needs a name and at least one value, at most 2 variations ("A price for each combination" needs exactly two), at most 70 models on one variation, personalization questions need valid options, and attributes need a category first. Other failures mean the page lost its connection.

Fix:

1. Fix the field the message names, then press "Save master listing".
2. Pick a category first, then its attributes.
3. If saving keeps failing, reload the page (unsaved changes are lost) and make the change again.

"Copy to Etsy" (a draft from a master) fails

ID: master-listings-copy-to-etsy

Seen as:

• "Draft {…} was created, but part of the template could not be applied. ShopPilot blocked another create to prevent a duplicate. Review this draft in Etsy. Details: {…}"
• "The earlier create request had an uncertain network result. Check Etsy drafts before trying again; ShopPilot blocked a retry to prevent a duplicate."
• "This template has already created a draft for this shop."
• "This template is already being applied to this shop."
• "Listing quota check failed before draft creation."
• "Listing quota denied before draft creation."
• "Could not create the draft listing."
• "The saved template is missing required Etsy fields:"
• "The saved template is missing required Etsy fields: {…}."
• "The saved template needs a title and description."
• "The saved template has an invalid price."
• "A saved personalization question is missing its Etsy options."
• "A saved variation-photo link could not be matched in the target draft."
• "One {…} could not be added: {…}"

People say: "Copy to Etsy blocked", "a draft was created but part failed"

Why: "Copy to Etsy" makes one Etsy draft from the master in the active shop. ShopPilot blocks a second try when a draft was already made, when one is being made, or when the first try's answer got lost, so you never get duplicate drafts. It also stops when the master lacks required Etsy fields or the shop's listing allowance check fails.

Fix:

1. Look in your Etsy shop's drafts first. If the draft is there, finish it on Etsy.
2. If part of the master could not be applied, fix that part on the Etsy draft.
3. Fill in any field the message names in the master ("Edit"), then try again.

Notes: Runs never need "Copy to Etsy"; choosing the master on a niche is the whole setup.

Registry: entries can't be loaded or removed

ID: master-listings-registry

Seen as:

• "Could not load your listings."
• "Could not load your listings. Please try again."
• "Registry entry not found for the active shop profile."
• "Registry entry not found."
• "That entry could not be removed. Please try again."
• "Could not remove it. Please try again."
• "Preview not found"
• "Duplicate protection blocked {…} because it already has a recorded {…} listing.{…}"
• "Delete {1} from Etsy? This cannot be undone. The registry will keep a deleted record."

People say: "Registry is empty", "duplicate protection blocked"

Why: The Registry shows the active shop's records. "Duplicate protection blocked ... already has a recorded listing" means a folder already made a listing in that shop, so ShopPilot will not make it again by accident.

Fix:

1. Make the right shop active and reload "Registry".
2. Duplicate protection: if you really want a second listing from the same folder, check Etsy first. Forgetting the Registry record (only if the old listing is gone on Etsy) lets the folder run again.
3. "Forget" removes only ShopPilot's record, never the Etsy listing.

"Save to server" could not be changed

ID: master-listings-save-to-server

Seen as:

• "Save to server could not be changed. Please try again."
• "Save to server is on. Try again."

People say: "Save to server switch won't change"

Why: The "Save to server" switch decides whether generated folders stay on ShopPilot or are removed after saving to your PC. The change failed because the page lost its connection.

Fix:

1. Reload the page and switch it again.
2. If the Bridge is closed, turning on "Save to server" lets generated folders stay on ShopPilot; then try your action again.

Rare technical messages (Niches and masters)

ID: master-listings-rare

Seen as:

• "Master listing data could not be read."
• "Master listing data has an unsupported format."
• "Master listing data is too large."
• "Master listing image could not be previewed safely."
• "Master listing image is too large to preview safely."
• "Master listing image was not found."
• "Mockup editor asset failed to load."
• "That master listing request could not be completed. Nothing was changed. Please try again."
• "Master listing request failed."
• "the print service could not produce mockup template {1}."

Why: Internal checks of the master library and the editor. Nothing was changed.

Fix:

1. Reload the page and try once more.
2. If one master keeps failing, "Duplicate" it or add it again.

If still stuck: contact ShopPilot support with the master's name and the exact message.

Not errors: labels and notes (Niches and masters)

ID: master-listings-not-errors

Seen as:

• "Our mockup generator names this slot. Folders it built already match."
• "Don't show again for this niche"
• "Required"
• "If your designs are already in the selected folder, you can now create listings for this shop."
• "Niches you add are yours to set up. The shop owner’s niches are shared with the whole team, so changing them needs the owner’s permission."
• "Every run reads its category, gallery, variations and base copy from a master. Choose opens your library, where you can pick one or add the built-in phone-case starter — neither needs anything on Etsy. To use one of your own Etsy listings, add it in Master Listings with Add from Etsy."
• "Every run reads its category, gallery, variations and base copy from the master you pick here, and none of them has to exist on Etsy. If nothing in the list fits, add the built-in phone-case starter with the button at the bottom of this dialog."
• "Each pair has its own price, as on Etsy. An empty price uses the Price above. Untick Visible to stop selling a pair."
• "Select the wording it should replace, then pick a marker. With nothing selected it drops in at the cursor."
• "Nothing here."
• "It is missing"
• "Leave blank to use the built-in prompt. What you type yourself (the title template, extra instructions, banned words, required keywords and the custom prompt) gets a small cached safety check when it changes; normal listing wording is allowed. If that check cannot run, nothing on this page is saved."
• "Processing time, shipping policy, return policy, common Q&A… Example: - Processing: 2-3 business days - Shipping: tracked, 5-10 days - Wrong case received? Send a photo — we fix it free"

Pinterest cookies are missing, or "Auto-extract from Chrome" fails

ID: curate-pinterest-cookies

Seen as:

• "Missing Pinterest cookies — fully close the Pinterest Chrome profile, then click Auto-extract from Chrome."
• "Missing Pinterest cookies. On a Mac the easiest way: sign in to Pinterest, export cookies.txt with the “Get cookies.txt LOCALLY” extension, then press Upload cookies.txt. Auto-extract from Chrome also works if you choose Allow in the Mac’s Keychain box."
• "The Mac’s Keychain box was refused or not answered, so Chrome’s cookies could not be read. Easiest: export cookies.txt with the “Get cookies.txt LOCALLY” extension while signed in to Pinterest, then press Upload cookies.txt. Or press Auto-extract again and choose Allow."
• "Curate needs your Pinterest cookies. Without them Pinterest shows only a few, weaker results. Press Auto-extract from Chrome, or sign in to Pinterest, export cookies.txt with the “Get cookies.txt LOCALLY” browser extension and press Upload cookies.txt. On a Mac, uploading is the easiest way."
• "Pinterest cookie extraction failed:"
• "Bridge returned an empty cookie file."
• "Could not read Pinterest cookies from Chrome."
• "No usable Pinterest cookies found in common Chrome profiles."
• "No usable Pinterest cookies found in common Chrome profiles. {…}"
• "No Pinterest cookies found in that Chrome profile."
• "Chrome has Pinterest cookies, but the logged-in session cookie (_pinterest_sess) could not be read"
• "Chrome has Pinterest cookies, but the logged-in session cookie (_pinterest_sess) could not be read{…}. {…}"
• "Nothing failed to decrypt, so this is a sign-in and not a permission problem: open Chrome, sign in to pinterest.com, and check it is the same Chrome profile the Bridge reads"
• "Signed-in Pinterest requests were refused; retried signed out."
• "Skipped {…} unreadable Chrome cookie(s)"
• "Could not read {…} from macOS Keychain."
• "macOS Safe Storage is unavailable on this platform."
• "macOS Keychain returned the wrong Chromium Safe Storage key."
• "This Chromium cookie uses an unsupported macOS encryption format."
• "The bridge could not load its Chromium cookie extractor. Rebuild the bridge executable. Import details: {…}"
• "The bridge could not load its Pinterest cookie extractor. Rebuild the bridge exe, or use the 'Upload cookies.txt' flow."
• "Cookies upload failed: {1}"
• "Cookies upload failed:"
• "No file was received. Choose your cookies.txt again."
• "These Pinterest cookies have no sign-in, or it has expired. Sign in on pinterest.com with “Remember me” checked, then press Auto-extract from Chrome again or upload a new cookies.txt."
• "This file is too big for a cookies.txt (over 256 KB). Export only pinterest.com’s cookies with the “Get cookies.txt LOCALLY” extension, then upload that file."

People say: "missing Pinterest cookies", "auto extract doesn't work", "Keychain asks for a password", "cookies upload failed"

Why: Curate needs your Pinterest sign-in (cookies). "Auto-extract from Chrome" reads them through the Bridge from Chrome on this computer. It fails when the Chrome profile with Pinterest is still open (Chrome locks its cookies), when you are not signed in to Pinterest in that Chrome profile, when the sign-in expired, when the Mac's Keychain box was refused or not answered, or when the Bridge is not open and paired. An uploaded file fails when it is not a cookies.txt file, is not plain text, or is too big (over 256 KB).

Fix:

1. Easiest (always works, best on a Mac): in Chrome, sign in to pinterest.com with "Remember me" ticked. Install the "Get cookies.txt LOCALLY" extension, export the cookies for pinterest.com only, then press "Upload cookies.txt" in Curate and choose that file.
2. Or press "Auto-extract from Chrome": first fully close the Chrome profile where Pinterest is signed in (all its windows), keep the Bridge open, then press the button. On a Mac, choose "Allow" (or "Always Allow") in the Keychain box.
3. Check that the line under the buttons says "Cookies present".
4. "These Pinterest cookies have no sign-in, or it has expired": sign in to Pinterest again, then extract or upload again.
5. "The bridge could not load its ... cookie extractor": install the newest Bridge from "Connect Etsy", or use "Upload cookies.txt".

If still stuck: contact ShopPilot support with the exact message and Windows or Mac.

Notes: The cookies are used only to collect Pinterest images for your Curate runs. "Remove cookies" deletes them from ShopPilot.

The run stops, pauses, or loses the Bridge while collecting

ID: curate-bridge-collecting

Seen as:

• "Lost the connection to the Bridge while collecting {1}. Keep it open, then press Continue.{2}"
• "Lost contact with the desktop Bridge. Anything it did collect is kept — use"
• "That collection was stopped, so it was not curated. Anything already"
• "ShopPilot Bridge on your PC, then press Curate again — nothing collected is lost."
• "Pausing — the desktop Bridge is finishing the request it had already started."
• "The desktop Bridge is letting go of a collection that was stopped."
• "It will let go on its own — nothing already collected is lost."
• "Previous collection stopped. Starting the new one…"
• "The desktop app has taken the stop and is finishing requests it had already started."
• "Collection stopped"
• "Paused. Everything collected is kept — press “Continue unfinished curate” to pick up from here."
• "Paused.{1} Press “Continue unfinished curate” to pick up from here."
• "{1} is paused — press “Continue unfinished curate” to pick up from here."
• "Paused."
• "Nothing was running here."
• "Couldn’t pause just now — try again in a moment."
• "Couldn’t cancel just now — try again in a moment."
• "Continuing where it stopped"
• "There is nothing left to continue."
• "Nothing is left to continue — those collections were deleted or no longer have search queries."
• "Curating the {1} image{2} already collected — nothing was collected again."
• "Using the images already collected"
• "These images were already curated with the same settings, so no new run was started and nothing was counted. The sets are in your gallery."
• "Nothing collected"
• "The Bridge stopped without collecting any usable images for this collection."
• "Bridge {1} cannot run the full-volume Curator."
• "Pinterest scrape failed."
• "The Bridge is already scraping another Curator collection or preparing to restart. Wait for it to become idle."
• "The Curator collection was stopped."

People say: "curate stopped", "lost contact with the Bridge", "it says paused", "nothing collected"

Why: Pinterest images are collected by the Bridge on your computer. The run pauses or stops when the Bridge is closed or loses its connection, the computer sleeps, you press "Stop" or "Cancel", or the Bridge is still finishing a stopped collection. Whatever was collected is kept. "Nothing collected" means the Bridge finished without any usable images for that collection (see "Too few images").

Fix:

1. Open the ShopPilot Bridge and keep it open (and the computer awake) while the run collects.
2. Press "Continue unfinished curate": it picks up from where it stopped, also for collections it did not reach yet. Nothing collected is fetched again.
3. If it says the Bridge is still letting go of a stopped collection, wait a minute and start again.
4. "Already curated with the same settings": nothing new was run or counted; the sets are already in "6. Curated images".
5. "Bridge ... cannot run the full-volume Curator" or the Bridge needs an update: install the newest Bridge from "Connect Etsy".

If still stuck: contact ShopPilot support with the collection name, the time and the exact message.

Notes: Continuing is safe: it does not collect the same images twice and does not count the same run twice.

Too few images, or Pinterest blocks or limits the collecting

ID: curate-too-few-images

Seen as:

• "Pinterest had nothing usable for {1}.{2}"
• "The Bridge did not provide enough size-compatible images for any collection: {…}. ShopPilot needs one full set per collection, so no embedding run was started. Use several specific visual searches or increase Results per search, then try again."
• "The Bridge uploaded {…} candidate image{…}, but only {…} fit the {…} size and orientation rules. ShopPilot needs at least {…} matching images to form one set, so no embedding run was started. Use several specific visual searches or increase Results per search, then try again."
• "{…} ({…} of {…} fit; needs {…})"
• "(stopped early to keep storage free; completed sets preserved)"
• "Pinterest is rate limiting this IP - wait a few minutes and retry."
• "Pinterest's CDN (…) is blocking this computer's IP address, so the request never reached Pinterest. Stop retrying for 30-60 minutes, or run the collection from a different network (for example a phone hotspot)."
• "Pinterest candidate downloads failed ({…})."
• "Candidate upload failed ({…}/{…}): {…}"
• "Converted image exceeds the 5 MB candidate limit."
• "Converted transparent image exceeds the 5 MB candidate limit."
• "Pinterest image dimensions exceed the Curator safety limit."
• "Pinterest returned an unsupported decoded image type."
• "Pinterest returned an unsupported image type."
• "Pinterest image exceeds the 5 MB candidate limit."
• "Pinterest returned an empty image."
• "Pinterest returned invalid image metadata."
• "duplicate filename"
• "duplicate normalised filename"
• "file exceeds the 5 MB curator image limit"
• "converted image exceeds the 5 MB curator image limit"
• "legacy image conversion exceeds the per-request pixel budget"
• "unsupported decoded image type"
• "unsupported file type"
• "Curator image dimensions exceed the decode safety limit."
• "Image could not be decoded safely"
• "Image dimensions exceed the curator decode safety limit."

People say: "curate found nothing", "no sets were made", "Pinterest is blocking"

Why: A set needs enough images that fit the chosen "Design target" and size limits. Too few fit when the searches are very narrow, "Results per search" is low, the size limits or "Picture similarity" are strict, or Pinterest returned few results (no cookies, or Pinterest limited this computer's address after many requests). Single images are also skipped when they are not a supported picture type or are too large.

Fix:

1. Use several specific visual searches (for example "watercolor lemons pattern" rather than "summer").
2. Raise "Results per search" in "4. Tuning", or relax "Picture similarity" and the min/max sizes.
3. Check that "3. Pinterest cookies" says "Cookies present".
4. If Pinterest is limiting or blocking this computer: stop for 30 to 60 minutes before trying again, or run from a different network (for example a phone hotspot).
5. Then press "Continue unfinished curate" or run the collection again.

Notes: Skipped images do not stop the run; only the usable ones are kept.

References: images not accepted, or can't be removed

ID: curate-references

Seen as:

• "No valid images received."
• "No files received."
• "Could not remove the references."
• "Could not remove that reference."
• "Reference not found."
• "That could not be deleted. Please try again."

People say: "No valid images received", "references won't upload"

Why: References (and images the Bridge sends in) must be JPG, PNG or WEBP pictures of at most 5 MB each, with different file names. When none of the files in one upload fits, nothing is saved ("No valid images received"). Removing fails when the page lost its connection or the reference was already removed.

Fix:

1. Save the images as JPG or PNG under 5 MB each, with different names.
2. Press "+ Add references" again and choose 3 to 10 images.
3. If removing fails, reload the page and try again.

Notes: If this appears during a run, some collected images were not usable; the run continues with the rest. If no set is made, see "Too few images".

A curate run won't start

ID: curate-run-start

Seen as:

• "A curate is already running. Press Cancel first to start a different one."
• "Already collecting images for a run — hold on."
• "Another ShopPilot tab is already collecting images for a run. Keep that tab open or wait for it to finish."
• "Couldn’t start the curate:"
• "Could not reach ShopPilot to start the run. Your uploaded images were kept — check your connection and press Run again."
• "Could not start:"
• "The server is busy right now — please try again shortly."
• "This run would go over a limit on your plan."
• "A curate run is already in progress."
• "Give it a moment, then try again."
• "Someone else is preparing a curate right now. Try again once it has started."
• "The run could not be started."
• "Could not restart:"
• "“Curate collections” uses one Curate run per collection you tick. {…} collections need {…} runs and you have {…} left today. Untick {…} collection{…} and start again, or upgrade for unlimited."
• "Add search queries to a collection first."
• "No collection has search queries yet, so there is nothing to curate."
• "{…}. Please try again in a few minutes."
• "{…}. The longest-running one started {…} ago, already past the usual {…}, so a spot should free up soon."
• "Curator already has the maximum {1} search queries."
• "The scraped images can't be cleared while they're being used. Cancel the run first."
• "Could not clear the previous candidate cache."

People say: "Curate button does nothing", "a curate is already running", "would go over a limit"

Why: Only one curate runs at a time per account, and another tab or a team member may already be running or preparing one. The collection may have no search queries. A free trial allows 2 Curate runs a day, and there "Curate collections" uses one run per ticked collection (some access keys have their own limits too). ShopPilot may also be busy for a few minutes.

Fix:

1. Close other ShopPilot tabs that are collecting, or wait for that run to finish. To start a different one, press "Cancel" first.
2. Add search queries to the collection ("3. Search queries", one per line, up to 10).
3. Over the daily limit: untick some collections, or wait until the limit resets (trial limits reset at midnight in your time zone).
4. "The server is busy" or a spot "should free up soon": try again in a few minutes.
5. "Could not reach ShopPilot": check your connection and press run again; uploaded images are kept.

If still stuck: contact ShopPilot support with the exact message.

Storage is full: Curate won't start a new run

ID: curate-storage

Seen as:

• "Storage almost full — only {1} left. Curate always leaves {2} free, so a new run cannot start."
• "{1} left. Delete curated images you no longer need, or your next curate run may not start."
• "Storage is running low — delete images you no longer need before the next run."
• "Only {…} of your storage is free. Curate always leaves {…} free so the rest of ShopPilot keeps working, so there is no room for a new run. Delete curated images you no longer need, or clear finished listing folders, then start the run again."
• "Delete curated images you no longer need: select them in Curated images and press Delete, or clear sets you have already downloaded."
• "The server is temporarily low on disk space, so new curate runs are paused. Your uploaded images were kept — please try again shortly."
• "To free space: select curated images you no longer"
• "Could not delete those images right now."
• "Could not clear the sets right now."

People say: "storage almost full", "curate needs free space"

Why: Curated images use your ShopPilot storage. Curate always leaves some space free so the rest of ShopPilot keeps working, so a new run can't start when storage is nearly full. Rarely ShopPilot itself is short of space for a moment ("temporarily low on disk space").

Fix:

1. In "6. Curated images", select images you no longer need and press "Delete", or press "Clear all images" for sets you already downloaded or used.
2. Delete other old files you no longer need (listing folders, mockups).
3. Start the run again.
4. "Temporarily low on disk space": try again shortly; your uploads are kept.

Notes: Deleting curated images cannot be undone. Save them to your PC first ("Save to PC") if you want to keep them.

Auto Curate: search suggestions fail

ID: curate-search-suggestions

Seen as:

• "Live sources are unavailable right now. Try again shortly or enter searches manually."
• "Live sources could not be reached, so these searches come from ShopPilot's most recent knowledge. Double-check that each subject is still current."
• "Live sources could not produce a usable search set. Try again shortly or enter searches manually."
• "Search intelligence is unavailable right now. Try again shortly or enter searches manually."
• "Search intelligence is unavailable, so ShopPilot did not invent generic art-style filler. Try again shortly or enter searches manually."
• "The generator could not produce a list of distinct public names. ShopPilot did not pad it with generic art-style searches; try again shortly."
• "The generator did not produce usable subject-led searches. Try again shortly or enter searches manually."
• "Describe the design batch first."
• "Search generation could not connect. Try again."
• "Search generation failed."
• "Describe the aesthetic first."
• "That theme is already in Curator searches."
• "The theme is visible in Curator, but auto-save failed."
• "Curator could not load. Try again in a moment."

People say: "Generate searches does nothing", "search intelligence unavailable"

Why: "Generate searches only" turns your description into specific Pinterest searches with ShopPilot's AI. It fails when the description is empty, when the AI or live lookup is not available for a moment, or when it could not make good, specific searches (it does not fill the list with generic ones).

Fix:

1. Write a description in "Auto Curate (optional)" (for example "boho floral" or "football stars").
2. Press "Generate searches only" again after a minute.
3. Or type your own searches in "3. Search queries", one per line.

Notes: When the live lookup is unavailable, suggestions come from ShopPilot's latest knowledge; check that each subject is still current.

Collections: can't create, switch, rename or delete

ID: curate-collections

Seen as:

• "Could not save the current collection’s settings, so the switch was cancelled. Try again."
• "Could not switch collection:"
• "Could not load collections."
• "Could not load your collections. Close this and try again."
• "Could not create collection."
• "Could not reach ShopPilot. The collection was not renamed."
• "Could not reach the server, so nothing was deleted. Try again in a moment."
• "Maximum of {…} collections reached."
• "Name the collection first."
• "Collection not found."
• "Could not load collection settings ({1})."

People say: "can't switch collection", "collection not found"

Why: The page lost its connection to ShopPilot for a moment, the collection was deleted in another tab, it has no name, or the account has the maximum number of collections.

Fix:

1. Reload the page and try again.
2. Give a new collection a name before saving.
3. At the maximum, delete a collection you no longer use.

Curated sets don't load or can't be downloaded

ID: curate-sets-load

Seen as:

• "Run finished, but your sets could not be loaded just now — press Refresh below."
• "Set results could not be loaded yet. Press Refresh in Curated Sets."
• "Could not load curated sets ("
• "Could not load sets — press Refresh."
• "No sets yet — run the curator first."
• "Save this image from the Curate page first."
• "Curated-set download exceeds the 500-file or 1 GB archive limit."
• "No selected images were available to download."
• "No images selected"
• "No images selected."

People say: "sets don't show after the run", "download too big"

Why: The run finished but the page could not load the sets at that moment, no run has made sets yet, nothing is selected, or a download is bigger than one archive can hold (500 files or 1 GB).

Fix:

1. Press "Refresh" in "6. Curated images".
2. Select the images or sets first, then the action.
3. For a big download, select fewer sets at a time.

Running sets into mockups or listings fails ("Multi-set run failed")

ID: curate-sets-run

Seen as:

• "Multi-set run failed:"
• "No design folders were saved — check the output log."
• "Auto-prep failed:"
• "Stopped:"
• "Run stopped"
• "Run stopped."
• "Listing batch timed out while waiting for the previous shop."
• "Design files only needs a phone-case product. Pick one under "Which mockup?" and run it again."
• "Place the designs in the mockup editor first, then close it to save them."
• "Those images could not be opened."
• "Those images could not be prepared. Please try again."
• "Saving the editor designs failed"
• "These designs could not be saved. Close the editor and open it again from the set."
• "Send failed:"
• "Auto-prep is unavailable right now. Please try again."
• "prepared image exceeded the memory safety limit"
• "empty file"
• "image is too large to prepare"
• "Upload failed. Please try again."
• "Too many changes. Try again in a few minutes."
• "Preview unavailable"
• "Could not switch the Curate shop profile"
• "Could not switch the active shop. Please try again."

People say: "multi-set run failed", "auto-prep failed", "nothing was saved after running sets"

Why: Running sets fits each picked design to the product (auto prep), makes mockups, then runs the step you chose for each set's shop. It stops when a design can't be prepared (empty, broken or very large image), the Bridge is closed when files must be saved to your PC, a set's shop can't be used (not connected to Etsy, no master listing, proxy problem), the run was stopped, or ShopPilot was busy. The text after "failed:" says which.

Fix:

1. Read the text after "Multi-set run failed:" or "Auto-prep failed:" and fix that first (for shop problems see the Create Listings and Niches sections).
2. Keep the Bridge open if the run saves to your PC.
3. "Design files only needs a phone-case product": pick a phone model under "Which mockup?".
4. With "Auto prep design placement" off, place the designs in the mockup editor first and close it to save them.
5. "Could not switch the Curate shop profile": reload the page and pick the set's shop again.
6. Run the sets again. Sets that finished are kept.

If still stuck: contact ShopPilot support with the exact message and the time.

Notes: "Mockups + Publish live" makes real Etsy listings. Before running the same sets again, check your Etsy shop for listings that were already made, so you don't publish the same design twice.

Pin Picker extension problems

ID: curate-pin-picker

Seen as:

• "Could not create a token."
• "Could not create a pairing token. Please try again."
• "Pairing required."
• "No image received."
• "That image could not be read."
• "That image was empty."
• "Nothing to remove."
• "Removed, but the folder could not be renumbered."
• "That slot is already empty."
• "Nothing to undo."
• "That design could not be removed. Please try again."
• "Pin Picker build not available."
• "Copy failed"

People say: "Pin Picker says pairing required", "picks don't arrive"

Why: The extension must be paired with a token from Curate. A token is shown once; a new one replaces the old. Picks fail when the image can't be read, or when removing or undoing a pick that is no longer there.

Fix:

1. In Curate press "Create pairing token", copy it right away and paste it into the extension's popup.
2. If "Copy chrome://extensions" fails, type chrome://extensions into Chrome's address bar yourself.
3. Reload the Pinterest page after pairing.
4. If a pick fails, try that pin again.

Rare technical messages (Curate)

ID: curate-rare

Seen as:

• "unknown error"
• "Could not save guide completion. Use Continue Curate guide to try again."
• "Could not save the Curate-guide preference."

Why: The page lost its connection to ShopPilot for a moment, or it could not save how far you got in the Curate guide. Nothing else was changed.

Fix:

1. Reload the page.
2. Try the action once more (for the guide: "Continue Curate guide").

If still stuck: contact ShopPilot support with the exact message.

Not errors: labels and notes (Curate)

ID: curate-not-errors

Seen as:

• "({…} duplicate(s) removed within sets)"
• "“Curate collections” asks which collections to include, then runs the ones you tick back-to-back in one job (loads the image matcher once). Collections with no search queries yet cannot be picked. If a curate is interrupted part-way, Continue picks up every collection it did not reach — not just the one on screen."
• "ShopPilot turns broad categories into specific names and short Pinterest searches. Words such as current, trending, or news trigger a live lookup. You can also leave this empty and enter your own searches below."
• "Chrome refuses to open a chrome:// address from a link, so it is copied to your clipboard instead"
• "Read Pinterest cookies from your local Chrome via the Bridge. Fully close the separate Chrome profile where Pinterest is logged in first."
• "Auto prep is off, so the run opens every design in the mockup editor first:"
• "Auto prep is off, so the run opens them in the mockup editor first:"
• "Yes. The 5-day free trial needs no card and includes 2 design searches a day, with up to 200 designs each, and 30 designs a day saved with the browser extension."
• "Poster mode accepts flexible 2:3, A-series, 3:4 and 4:5 poster proportions in either orientation. The pixel range is a source-quality baseline, not a fixed print size. Frames, room mockups and mostly empty layouts are blocked, and photography is capped at 20% per set."
• "This frees up storage and cannot be undone."
• "their collected images, so nothing is gathered again."
• "What is already collected is kept."
• "OK — curate those now (nothing is collected again)."

"No design images are chosen yet" (Generate pressed with nothing chosen)

ID: mockups-no-designs

Seen as:

• "No design images are chosen yet. Drop them on the “Choose design images” box above, or press Browse in it."
• "Select at least one mockup template"

People say: "Choose design files first", "Generate does nothing", "no design images chosen", "select a multiple of 5 files", "select at least one mockup template"

Why: Generate needs design images in step 1 (older versions said "Choose design files first"). A second check says "Select a multiple of 5 files. You selected N." when a phone-case batch is not complete: five designs make one folder. A third check says "Select at least one mockup template" when no template is ticked in step 2.

Fix:

1. Drop your images or PDFs on "Choose design images" (or press "Browse"), then press "Generate & auto-save folders".
2. For phone cases choose 5, 10, 15 ... files. Remove or add files until the count is a multiple of 5.
3. For Poster, Smart mockups or PSD mockups choose one design per folder you want.
4. Tick at least one template in step 2 (the first photo of a phone-case set is always ticked).
5. Wait until the tiles finish fitting ("Fitting designs to the case...") before pressing Generate.

Notes: Nothing was made when this message shows, so pressing Generate again is safe.

A design file is refused or cannot be used

ID: mockups-design-file-refused

Seen as:

• "Image {…} must be a PNG, JPEG, WebP, or PDF file."
• "Image {…} was empty."
• "Image {…} could not be prepared. Check that it is a valid, readable image."
• "Image {…} could not be decoded as a supported image."
• "One of the selected designs could not be prepared as an image."
• "Uploaded image was empty."
• "No file received."
• "Image {…} has unsafe dimensions. Maximum decoded size is 50 megapixels."
• "Design image dimensions exceed the decode safety limit."
• "That design is too long and thin to fit the case. Crop it closer to the case's shape and upload it again."
• "embedded originals, then try again."
• "Could not decode image"
• "Decoded image exceeds the {…}-pixel limit."
• "picture size unreadable"
• "Could not encode JPEG"
• "could not encode the moved collage"
• "Could not save the prepared design folder."
• "Design folder save failed"

People say: "Image must be a PNG, JPEG, WebP or PDF", "design too long and thin", "design is too big", "image was empty", "Design folder save failed"

Why: Designs must be PNG, JPEG, WebP or PDF files that open normally and are not empty. A file bigger than the upload limit (95 MB by default) is refused before upload. A picture with extreme proportions (very long and thin) cannot fit the case. A picture with too many pixels (over about 50 megapixels) is refused to protect the system. A file the browser could not read any more (moved, renamed or changed after you picked it) must be picked again.

Fix:

1. Open the file on your computer. If it does not open, export a fresh PNG or JPEG.
2. Make it smaller: flatten layers, save at 300 DPI, or save the PDF without embedded originals.
3. "That design is too long and thin to fit the case": crop it closer to the shape of a phone case (about 1 : 2.1) and upload it again.
4. Pick the file again if it says it could not be read from your computer or did not reach ShopPilot (check your internet connection).
5. "Design folder save failed": try again; with "Design files only", check that the Bridge is open or that "Save to server" is on.

If still stuck: contact ShopPilot support with the file type, its size in MB and the exact message.

Notes: Files that fail are skipped; nothing was saved for that folder, so you can fix the file and run it again.

Auto prep failed, or a set was stopped before its mockups

ID: mockups-auto-prep-failed

Seen as:

• "Auto prep failed: {1}"
• "Could not prepare batch {1} ({2})."
• "Could not be prepared"
• "Set "{1}" prep failed: {2}"
• "Folder {1}/{2} ("{3}") stopped before mockups: {4}"
• "Folder {1}/{2} ("{3}") stopped: no usable prepared designs."
• "Mockups finished with problems — {1} folder{2} ready, {3} set{4} failed."
• "Mockups finished with problems"
• "{1} set{2} failed — see Mockups progress"
• "Nothing was saved for this folder, so you can fix the cause and run it again."
• "Opened the mockup workspace, but it didn't accept the files automatically. Drag the {1} images in manually."
• "Place "{1}" in the mockup editor first, then close it to save."
• "The run has already started — this set can no longer be changed."
• "The model could not be saved. Try again."
• "Auto prep failed: Connect your Etsy shop to start using your free trial." (older wording)

People say: "Auto prep failed", "set prep failed", "mockups finished with problems", "the run has already started", "place it in the mockup editor first"

Why: "Auto prep failed: ..." ends with the reason. An older version of the free trial refused Auto prep until an Etsy shop was connected ("Connect your Etsy shop to start using your free trial"); today Create Mockups works before the shop is connected, at half the daily amount. Auto prep fits each design to the case. It can fail for a whole run (you went offline, ShopPilot was busy) or for one design or set (a file that cannot be read, no usable design left). A folder that fails is skipped and the run goes on with the next one; the end of the run says how many folders are ready and how many sets failed. "Nothing was saved for this folder" means the failed folder left nothing behind. "The run has already started — this set can no longer be changed" appears when you try to edit a design after its mockups started. With "Manual prep" the run first opens each design in the mockup editor ("Place ... in the mockup editor first, then close it to save", "Drag the N images in manually").

Fix:

1. Check your internet connection and press Generate again; failed sets are listed by name in the log under "Progress".
2. Remove or replace the design that failed (see "A design file is refused") and run that set again.
3. If Auto prep keeps failing, switch "Mode" to "Manual prep", place the designs in the mockup editor and close it to save.
4. Wait for the six-second look to finish before changing a design; fix a design only before its mockups start.
5. "The model could not be saved": the "Auto prep model" choice (a row that is not shown on every account) could not be saved; reload the page and try again, or leave it as it is.

If still stuck: contact ShopPilot support with the exact message and which set (folder) failed.

Notes: Folders that finished are kept. Run again only the sets that failed (they are named in the log); running the whole batch again would make new folders for the sets that already worked.

"The mockup run could not be completed" and other failed runs

ID: mockups-run-failed

Seen as:

• "The mockup run could not be completed."
• "the step could not be completed."
• "The local mockup renderer failed on this folder."
• "The poster mockup renderer failed on this folder."
• "Could not save the mockup folder."
• "Too many mockups in one save (max {…})."
• "Generated folder has too many files (max {…})."
• "Mockup generation failed: {…}"
• "Could not download the mockup archive."
• "Generated mockup fallback also failed."
• "{…} Generated mockup fallback also failed."
• "The mockups were saved, but the listing run failed: {1}"
• "Poster auto-post failed"
• "The local mockup renderer produced no images."
• "The poster mockup renderer produced no images."

People say: "The mockup run could not be completed", "mockups finished with problems", "mockup generation failed", "mockups saved but the listing run failed", "the poster mockup renderer produced no images"

Why: "The mockup run could not be completed." is the general message of a run that stopped on an error; the real reason is in the line that starts with "ERROR:" in the log under "Progress" (when no reason is available that line says "the step could not be completed"). The run could not make or save the pictures of a folder. Common causes: a lost internet connection, ShopPilot busy, one design or template that cannot be rendered, too many pictures in one save, or ShopPilot's mockup service giving an error. "The local mockup renderer produced no images" and "The poster mockup renderer produced no images" mean that none of the ticked templates could be drawn for that folder (every one of them failed); try different templates or a different design. If the mockups were saved but the listing step after them failed ("The mockups were saved, but the listing run failed"), your folders are ready in "Create Listings" and only the listing needs to be run again.

Fix:

1. Read the "ERROR:" line in the log for the reason, and fix that first (a design file, the Bridge, your connection).
2. Wait a minute and press "Generate & auto-save folders" again with only the designs that did not get a folder. A folder that fails saves nothing, so there is no half-finished folder.
3. If one template always fails, untick it and run again, or contact support with its name.
4. "...the listing run failed": open "Create Listings", select the new folders and preview or create the listing from there.
5. "Poster auto-post failed": the posting after a poster run did not start; open "Create Listings" and run the folders from there.
6. Check the Bridge is open (and "Save to server" is on if you want to keep folders on ShopPilot).

If still stuck: contact ShopPilot support with the exact message, the product tab (iPhone PS, Poster, Smart or PSD) and the time.

Notes: A failed folder does not use up a free-trial mockup. Every successful run makes new folders, so do not run the whole batch again when some folders were already saved; check "Saved" first. Wait for the progress to finish before pressing Generate again.

ShopPilot's mockup service is unavailable ("contact the ShopPilot administrator")

ID: mockups-service

Seen as:

• "Provider session unavailable; contact the ShopPilot administrator"
• "Contact the ShopPilot administrator if the universal session is unavailable."
• "Cookie check failed"
• "Could not check the provider session:"
• "Provider session missing"
• "Provider session missing."
• "print service returned an error"
• "the print service returned a sign-in or error page instead of an image,"
• "which almost always means its session expired. Try the folder again, and contact the ShopPilot administrator if it keeps failing."

People say: "session unavailable", "contact the ShopPilot administrator", "the print service returned a sign-in or error page", "mockups stop coming back"

Why: Before every run the page checks that ShopPilot's mockup service is ready. When that check fails, or the service answers with an error page, a storage message of its own, or "contact the ShopPilot administrator", the problem is on ShopPilot's side, not on your computer, and only ShopPilot can fix it. The page then refuses to start so that nothing half-made is saved.

Fix:

1. Wait a few minutes and press "Generate & auto-save folders" again.
2. If it still fails, contact ShopPilot support and send the exact message, the time and the product tab you used.

Notes: Nothing was saved when this message shows. Your designs, shops and folders are not affected.

Auto-swap background: the background style or the model is not ready

ID: mockups-bg-swap

Seen as:

• "Background model still loading — try again in a moment"
• "bg-swap warnings:"
• "● could not reach model"
• "● model error:"
• "The background style could not be saved. Please try again."
• "Invalid background colour. Use #e9dde7 format."
• "no eligible mockups found in zip (check zip format)"

People say: "Background model still loading", "bg-swap warnings", "Background swap skipped", "background style could not be saved", "invalid background colour"

Why: "Auto-swap background" recolours the background of each phone-case mockup. The run waits until the background tool is ready ("Background model still loading - try again in a moment"). The style is saved to the active shop; if that fails, or the colour is not a #rrggbb value (for example #e9dde7), the style is not saved. "bg-swap warnings:" in the log lists pictures that could not be recoloured, and "Background swap skipped: ..." (for example "no eligible mockups found in zip (check zip format)" or "the renderer reported no image it could recolour") means the folder was saved without the new colour. "Background: rendered directly on the colour you chose" is not a problem: the colour was applied while the picture was drawn.

Fix:

1. Wait a moment and press Generate again if the tool was still loading.
2. Pick the colour with the colour box or type it as six hex characters, for example #e9dde7, then save the style again.
3. Switch "Auto-swap background" off for a run that does not need it.
4. Pictures with a photo scene behind them are kept as they are by design.

Notes: Posters, Smart mockups and PSD mockups use their own backdrop, so the swap applies to phone-case mockups only.

Free-trial limit reached while making mockups

ID: mockups-trial-limit

Seen as:

• "Your free trial limit was reached."

People say: "Your free trial limit was reached", "no more mockups today", "Folder 1 upload 1 failed: You've used today's free-trial Mockups"

Why: A free trial can make a limited number of mockup folders per day (see https://shoppilot.dev/free-trial). Before an Etsy shop is connected the trial gets half of that. The full message tells how many were used and when they come back (at midnight), for example "You've used today's 10 free-trial Mockups. They come back at midnight, or upgrade for unlimited." During a run it can appear as "Folder N upload M failed: ..." followed by that sentence.

Fix:

1. Wait until midnight (your time zone) for the allowance to come back, or connect your Etsy shop for the full daily amount.
2. Or choose a plan to remove the limit (see https://shoppilot.dev/pricing).

Notes: A folder that failed to render is not counted.

Mockup templates cannot be loaded, or are not available for the account or shop

ID: mockups-templates

Seen as:

• "Availability check failed"
• "That mockup template is not available for this account."
• "These mockups are not available for this account."
• "Could not load the mockup settings. Please try again."
• "That mockup is no longer in your library."

People say: "Availability check failed", "That mockup template is not available for this account", "That mockup is no longer in your library"

Why: The page asks ShopPilot which mockups your account may use. If that check fails, the tabs may stay empty. A template that is not available for the account (for example Smart mockups, when they are not switched on for your account) is refused. A mockup you deleted earlier is no longer in your library.

Fix:

1. Reload the page and wait for the tiles to appear.
2. Pick another template or tab, or untick the one that is refused.
3. If you need a template that is missing, contact ShopPilot support with your account email and the template name.

Notes: Deleting a mockup that is ticked in your gallery means a master listing that uses its photo will not find it in new folders; untick it instead if you only want it out of the next listing.

The Mockup Editor does not open, or an image does not load in it

ID: mockups-editor-open

Seen as:

• "Could not load the mockup editor"
• "Could not load the mockup editor. Please try again."
• "Failed to load:"
• "The image editor needs a larger screen — open it on a laptop or desktop."
• "Mockup editor asset missing"
• "decode failed:"
• "Could not add file to the mockup editor:"

People say: "Could not load the mockup editor", "The image editor needs a larger screen", "Failed to load", "decode failed"

Why: The editor is a large canvas tool that only opens on a laptop or desktop screen (the browser window must be at least about 900 pixels wide). It also fails to open when the page lost its connection while loading its files, or when an image in it cannot be decoded by the browser (a damaged file, or a format the browser cannot show).

Fix:

1. Use a laptop or desktop browser window and make the window wider; a phone or small tablet cannot open it.
2. Reload the page and open the editor again ("Mockup Editor" in the left menu, or "Open advanced editor").
3. If one image fails to load ("Failed to load: decode failed: <name>"), export it again as PNG or JPEG and open that.

If still stuck: contact ShopPilot support with the exact message and your browser.

Running mockups from the Mockup Editor fails

ID: mockups-editor-run

Seen as:

• "Editor mockup run failed:"
• "Editor run failed:"
• "Listing runner missing - try saving and running manually"
• "Mockup generator missing - try saving and running manually"
• "Nothing to run"
• "Run handler missing — try saving and running manually"
• "runMode failed:"
• "Editor mockups-only run failed:"
• "Mockup creation failed:"
• "Nothing to save"
• "Saved-to-queue listener failed:"
• "Editor close handler failed:"

People say: "Editor run failed", "Mockup creation failed", "Nothing to run", "Nothing to save", "Run handler missing"

Why: "Create mockups only" (and "Run pipeline") in the editor first saves every open tab as the artwork that goes on the case, then makes the mockups. It stops with "Nothing to run" or "Nothing to save" when no image is open in the editor. The "... missing - try saving and running manually" messages mean the page could not hand the saved artwork on to the mockup step, usually because the page was only half loaded.

Fix:

1. Open at least one image in the editor, then press "Create mockups only" (or "Run pipeline") again.
2. Reload the page, open the editor again and retry.
3. Or save your edits in the editor, close it and press "Generate & auto-save folders" on "Create Mockups".
4. A message ending with the reason ("Editor run failed: ...", "Mockup creation failed: ...") has the same causes as a normal failed run; see "The mockup run could not be completed".

If still stuck: contact ShopPilot support with the exact message.

Notes: "Create mockups only" does not touch Etsy. "Create mockups + listings" with "Run pipeline" hands the new folder to Create Listings for a preview, a draft or a publish; nothing is posted unless you pick "Draft" or "Publish live" there.

A Mockup Editor tool says there is nothing to work on

ID: mockups-editor-tools

Seen as:

• "Nothing to transform on this layer"
• "Draw a crop first"
• "Clipboard empty"
• "Could not save this preset in the browser"
• "Download failed — try again"
• "Enter a print size from 0.1 to 1000 cm per side"
• "Enter a name for this canvas size"

People say: "Nothing to transform on this layer", "Draw a crop first", "Clipboard empty", "Download failed", "Enter a print size from 0.1 to 1000 cm per side", "Enter a name for this canvas size"

Why: Free Transform needs a layer with pixels in it, Crop needs a rectangle drawn first, and Paste needs something copied or cut before. A canvas size must be a print size from 0.1 to 1000 cm per side, or 64 to 6000 pixels per side and no more than 9 megapixels, and a saved size needs a name. A saved canvas size preset is stored in your browser; if the browser blocks storage (private window, full storage) it cannot be kept. "Download failed" means the browser did not accept the download of the finished picture.

Fix:

1. Pick a layer that has artwork on it, then press Free Transform.
2. Draw the crop rectangle on the canvas, then press Apply.
3. Copy or cut a selection first, then paste.
4. Type a canvas size inside the limits above, press "Apply size", and give a custom size a name before "Save preset".
5. For a preset or a download problem use a normal (not private) Chrome window, allow downloads for ShopPilot and try again.

AI Upscale in the Mockup Editor does not work

ID: mockups-upscale

Seen as:

• "Select a layer first"
• "Nothing to upscale on this layer"
• "Upscale failed"
• "The upscaled image could not be loaded."
• "Could not prepare image for upscaling."
• "Image is too large for local upscaling."
• "Upscale failed: {…}"
• "Empty image upload."
• "Upscayl models were not found. Install Upscayl or set … to the folder containing .param and .bin model files."

People say: "Upscale failed", "AI upscaler is not installed", "Upscayl models were not found", "Image is too large for local upscaling", "select a layer first"

Why: AI Upscale in the Mockup Editor ("Upscale selected layer", and the "Auto-upscale low-res designs" box) runs on YOUR computer, through the ShopPilot Bridge and the free app Upscayl. They need: the Bridge open and paired, Upscayl installed, and a layer with pixels selected. Very large pictures are refused. The first run after installing Upscayl can fail until the Bridge is restarted.

Fix:

1. Install Upscayl (free, https://upscayl.org) on the same computer, open it once, then quit and restart the ShopPilot Bridge.
2. Make sure the Bridge is open and paired ("Connected"). The editor says "Bridge is not available" when it cannot reach it; see the Bridge help.
3. Select a layer that has artwork ("Select a layer first", "Nothing to upscale on this layer"), then press "Upscale selected layer".
4. "Upscayl models were not found": Upscayl is installed but its model files are not where the Bridge looks. Reinstall Upscayl with its standard installer, open it once, and restart the Bridge.
5. "Image is too large for local upscaling" or "Upscale failed": use a smaller picture or the 2x scale instead of 4x, then try again.

If still stuck: contact ShopPilot support with the exact message, Windows or Mac, and the Bridge version.

Notes: The upscaling itself runs on your computer and nothing is sent to an outside service for it. Without Upscayl the editor and Create Mockups still work; only the sharpening is skipped.

"Add the buyer's text" (personalised phone-case orders) is refused

ID: mockups-personalised

Seen as:

• "ShopPilot could not read the design file."
• "This design file is {…} x {…}, not shaped like the phone case print (750 x 1590), so ShopPilot cannot tell where the camera is. Upload the case-shaped design file on the order, then add the text."
• "The words are too long to fit across the case. Use fewer letters, or two lines."
• "These words are in a script this server cannot print correctly (written right to left, or with joined letters). Upload a design file with the words on it instead."
• "This design file is a 32-bit image. Save it as an ordinary PNG or JPEG first."
• "The design file is too large to put words on here."
• "ShopPilot does not have the file of {…} Design {…} yet (a design only Alerio has cannot be used here). Upload the design file on the order, then add the buyer's text."
• "That order line cannot have a design file."

People say: "ShopPilot could not read the design file", "design file not shaped like the phone case print", "words too long", "script cannot be printed"

Why: On an Auto Orders order line that the buyer personalised, "Add the buyer's text" puts the words on the case-shaped design file (750 x 1590) away from the camera area and shows how it will print. It is refused when the design file cannot be read, is too large, is a 32-bit image, is not shaped like the case print (so the camera cannot be found), or when ShopPilot has no file for that design (a design that only Alerio has). The words are refused when they are too long for the width of the case, or are in a script that is written right to left or with joined letters, which ShopPilot cannot print correctly.

Fix:

1. Upload the case-shaped design file on the order ("Upload design file"), then add the text again.
2. Save a 32-bit image as an ordinary PNG or JPEG first.
3. Shorten the words, or split them into two lines.
4. For right-to-left or joined scripts, upload a design file that already has the words on it.
5. "That order line cannot have a design file": the line is not a printed item; use the line that is.

If still stuck: contact ShopPilot support with the order line and the exact message.

Notes: Nothing is kept or sent until you press "Use for this order".

A shop used the default pictures because it had none of its own picked

ID: mockups-shop-picks

Seen as:

• "Warning: {1} had no pictures of their own picked, so their folders used the default pictures"

People say: "had no pictures of their own picked", "used the default pictures", "Wait! pick its pictures first"

Why: When shops have their own mockups (Settings > Organization), each shop makes mockups only from the pictures picked for it. For iPhone PS a shop with nothing picked uses every picture the shop can use and the run says so at the end ("... had no pictures of their own picked, so their folders used the default pictures"). For Poster and Smart mockups a shop with nothing picked makes no mockups and the run says which shop has none.

Fix:

1. Make the shop active and open "Create Mockups" > the tab (for example iPhone PS or Poster).
2. Tick the pictures that shop should use.
3. Run again.

Notes: The "Wait!" window that offers "Open Mockups" has a "Don't show this again" box.

A folder could not be removed from the server after it was saved to your PC

ID: mockups-server-copy

Seen as:

• "Could not remove ... from the server"

People say: "Could not remove ... from the server"

Why: After a folder is saved to your PC, ShopPilot can remove its copy on the server. The removal failed (a lost connection, or the folder was already gone). Your PC copy is not affected.

Fix:

1. Ignore it, or remove the server copy later in "Create Listings".
2. Nothing else is needed.

Rare technical messages (Create Mockups)

ID: mockups-rare

Seen as:

• "Invalid hash format."
• "Invalid mockup batch size or sequence."
• "Missing hash."
• "missing url"
• "Missing url."
• "Photoshop mockups panel missing"
• "Shop profile routing is unavailable."
• "The selected shop profile could not be loaded."
• "That JPEG's structure could not be read."
• "Unsupported EXIF field type."
• "Invalid mockup project."
• "Unsupported mockup device selection."
• "This upload batch is already bound to another device type."

Why: Internal checks between the page and the server (a page that is out of date, a request that arrived incomplete, or a picture whose internal data could not be read). Nothing was changed.

Fix:

1. Reload ShopPilot (Ctrl+R, or Cmd+R on a Mac) and try the action once more.
2. If "The selected shop profile could not be loaded" shows, make the shop active again ("Manage" at the top of the left menu, then "Activate"; team members "Switch").
3. If one picture always fails, open it in an image editor, save a fresh JPEG or PNG and use that.

If still stuck: contact ShopPilot support with the exact message.

Not errors: labels and notes (Create Mockups)

ID: mockups-not-errors

Seen as:

• "Delete the “{1}” mockup?{2} The finish and the name you gave it go with it. Listings you have already generated keep their images."
• "A size chart, a care card or a shipping note is not a mockup. It goes into every listing exactly as it is, with no design on it and nothing to mark."
• "Also send the orders already waiting?"
• "Don't show this again"
• "Nothing here yet.<br><button class="ios-btn ghost small" type="button">Choose mockups</button>"
• "Nothing selected yet. Tap anything lying on the print"
• "Yes. The 5-day free trial needs no card and includes 10 mockup folders a day, on your own shop."
• "Yes. The 5-day free trial needs no card and includes 10 mockup folders a day."
• "Read fabric on this PC for sharper edges. It needs a one-time"

A PSD file is refused when adding it

ID: psd-mockups-add-refused

Seen as:

• "No PSD files there. Choose files that end in .psd or .psb."
• "Choose a Photoshop file (.psd or .psb)."
• "That file is empty or not a Photoshop file."
• "That file is over 2 GB. Save a smaller copy from Photoshop and try again."
• "That file's size could not be read."
• "That file is over 100 megapixels. Save a smaller copy from Photoshop and try again."
• "Those files are already in the list."
• "The server is short of space right now. Try again later."
• "You have too many files waiting. Finish or remove some first."
• "Your storage is full."

People say: "No PSD files there", "my PSD does not upload", "file is over 2 GB", "file is over 100 megapixels", "too many files waiting"

Why: The "Add" window takes files, not a dropped folder: dropping a folder (or a zip) gives "No PSD files there" even when the folder is full of PSDs. Use "Choose a folder" for a whole folder. ShopPilot takes Photoshop files that end in .psd or .psb; "No PSD files there" appears when none of the picked or dropped items ends in .psd or .psb, for example a dropped folder, a zip, or a picture. A file is also refused when it is not really a Photoshop file or is empty, is over 2 GB, has more than 100 megapixels, is already in the list, or when you have many files waiting that you have not set up yet. It is refused too when your storage is full or the space ShopPilot has for uploads is short at that moment.

Fix:

1. Choose files that end in .psd or .psb ("Choose PSD files"), or press "Choose a folder" to add all the PSD files in a folder. Do not drop a folder or a zip; a renamed picture or a zip is not a PSD.
2. Over 2 GB or over 100 megapixels: in Photoshop save a smaller copy (fewer pixels, flatten what you do not need) and add that.
3. "You have too many files waiting": set up or remove ("Remove this file") the files already in the list, then add the new ones.
4. "Your storage is full": check the storage bar at the bottom of "Settings", delete folders or mockups you no longer need, then add the file again. If the message says "You have uploaded N MB in the last 24 hours, and the most is N MB a day", the daily upload limit is reached: uploads count for 24 hours, so wait, or contact ShopPilot support to raise it.
5. "The server is short of space right now": wait a while and try again.

If still stuck: contact ShopPilot support with the file size and the exact message.

Notes: A file that is already in the list is not added twice. A file that already became a mockup can be added again to make another one.

The upload stops part-way, or says the upload is no longer open

ID: psd-mockups-upload-stops

Seen as:

• "That upload is no longer open."
• "A piece of the file could not be stored. It will be sent again."
• "A piece of the file was too big."
• "The upload was refused."
• "This file could not be uploaded."
• "The file could not be stored. Try again."
• "This page is out of date. Reload it and try again."
• "That did not work. Try again."

People say: "upload failed", "the PSD upload stopped", "that upload is no longer open", "upload was refused"

Why: A PSD goes up in small pieces and each piece is checked. The upload stops when you close the window or the page, the internet connection drops for a long time, you are signed out, or the upload stayed open for a long time without finishing and was cleared. A piece that arrives incomplete is sent again by itself.

Fix:

1. Keep the "Add your PSD mockups" window open and the computer awake until every row says "Reading the layers" or "Ready to set up".
2. If a row shows an error, remove it ("Remove this file") and add the file again.
3. If you were signed out, sign in again, then add the file again.
4. "This page is out of date. Reload it and try again.": reload ShopPilot (Ctrl+R, or Cmd+R on a Mac) and try again.

If still stuck: try a smaller copy of the PSD. Then contact ShopPilot support with the file size and the exact message.

Notes: Trying again is safe. Nothing is made until you set the file up and save.

ShopPilot cannot read the file, or it takes too long

ID: psd-mockups-read-fails

Seen as:

• "This file could not be read. Save a copy from Photoshop (8-bit RGB) and add that."
• "This file could not be read."
• "Reading this file stopped. Remove it and add it again."
• "This file needs more memory than a mockup may use. Save a smaller copy from Photoshop (fewer pixels or layers) and add that."
• "This file took too long to prepare. Save a smaller copy from Photoshop and add that."
• "The layers of this file could not be read."
• "Reading the saved PSD stopped. Try reading its parts again."
• "The layers of this file are still being read. Try again in a moment."
• "The layers of this mockup are still being read. Try again in a moment."

People say: "This file could not be read", "needs more memory", "took too long to prepare", "the layers could not be read"

Why: After the upload ShopPilot opens the PSD and reads its layers and smart objects. A file can fail when it is very large or has very many layers, is not 8-bit RGB (other colour modes are slower and may fail), or is damaged. "Reading this file stopped" means the reading was interrupted twice.

Fix:

1. In Photoshop open the file, choose 8-bit RGB mode, flatten or delete layers you do not need, and save a smaller copy (fewer pixels or layers).
2. Remove the failed row and add the copy.
3. "The layers of this file are still being read. Try again in a moment.": wait until the row says "Ready to set up" and try again.
4. A saved mockup that says "Reading the saved PSD stopped": press "Read the PSD again" in "Change where your design goes".

If still stuck: contact ShopPilot support with the file size, the number of layers if you know it, and the exact message.

A mockup could not be prepared or saved

ID: psd-mockups-prepare-fails

Seen as:

• "This mockup could not be prepared. Try again, or add the file once more."
• "This file could not be prepared. Try again, or save a copy from Photoshop and add that."
• "This mockup could not be prepared."
• "The refreshed mockup could not be prepared. Try again."
• "The refreshed mockup could not be saved. Try reading its parts again."
• "This mockup is being prepared. Try again when it is ready."
• "This mockup has no saved PSD to read. Add the PSD file again."
• "This mockup needs to be prepared again."
• "This mockup could not be saved. Try again."

People say: "This mockup could not be prepared", "stuck on preparing", "refreshed mockup could not be saved", "no saved PSD to read"

Why: After you tick the parts and save, ShopPilot prepares the mockup once. Preparing can fail for a file that is too heavy, or stop when the page was closed. "This mockup is being prepared" means it is still working. "This mockup has no saved PSD to read" means the original PSD is no longer stored for it.

Fix:

1. Wait until the tile no longer says it is being prepared, then try again.
2. If it failed, open the mockup with "Change where your design goes" and save it again, or press "Read the PSD again".
3. If the original PSD is gone, add the PSD file again and set it up.
4. If a layer covers the whole picture (some free mockups have one called "Delete me"), hide it under "Layers" in "Change where your design goes".

If still stuck: contact ShopPilot support with the mockup's name and number and the exact message.

Notes: A mockup that is not ready is left out of a run, so a listing never comes out short without telling you.

Choosing the parts: nothing ticked, or a part cannot take a design

ID: psd-mockups-parts

Seen as:

• "This part cannot take a design."
• "That is too many layers to change in one mockup."
• "That mockup has nothing to match."

People say: "tick at least one place", "this part cannot take a design", "nothing to match"

Why: A mockup needs at least one smart object that takes your design. A part cannot take a design when the PSD has no placement data for it. A file with no smart objects has nowhere to put a design. "Match the others to this one" needs a mockup with a main part for the design. Too many layer changes in one go are refused.

Fix:

1. Tick at least one part that shows your design, then save.
2. If no part can be ticked, open the PSD in Photoshop, turn the picture area into a smart object, save a copy and add that.
3. "That is too many layers to change in one mockup": undo some eye changes (the layer list has a "Back to how the PSD has it" button) and save in steps.
4. "That mockup has nothing to match": pick a mockup that has a part ticked for the design, then try "Match the others to this one" again.

Notes: If you have no PSD, "Smart mockups" (a photo of your own blank product with the print area marked) is the other way to use your own product photo.

Layers: hiding a layer or filling with the background colour does not work

ID: psd-mockups-layers

Seen as:

• "Show this layer first: a hidden layer cannot show the background colour."
• "Show that layer first: a hidden layer cannot show the background colour."
• "That layer cannot take the background colour."
• "This PSD has no light, gloss or shadow layers over the design, so this changes nothing."
• "The picture could not be updated."
• "The picture could not be updated. What you hide still applies when you save."
• "Your design goes in this part, so it stays showing."
• "That would hide a part your design goes in. Leave it showing."

People say: "Show this layer first", "your design goes in this part, so it stays showing", "that would hide a part your design goes in", "that layer cannot take the background colour", "the picture could not be updated", "shine does nothing"

Why: The eye of a part that your design goes in cannot be turned off: "Your design goes in this part, so it stays showing" and "That would hide a part your design goes in. Leave it showing." are a protection, not a fault. A hidden layer cannot show the background colour, so show it first. Only layers that have pixels or a fill can take the shop's background colour, and not the parts your design goes in. "This PSD has no light, gloss or shadow layers over the design" means the "Shine" control has nothing to change in that file. The preview picture is redrawn after each eye change; if that fails, what you hide still applies when you save.

Fix:

1. To hide something, use the eye of another layer (a sample sign, a number, a watermark), not the part your design goes in. To change where the design goes, use "Change where your design goes" and tick other parts.
2. Turn the eye on for the layer, then press the paint bucket ("Fill with your shop's background colour").
3. Pick another layer (usually the background layer) if the message says it cannot take the colour.
4. If "The picture could not be updated" shows, press the eye again or save; the saved mockup uses your choices.
5. "Back to how the PSD has this layer" undoes your change for that layer.

Edit, delete, restore or rename a section fails

ID: psd-mockups-edit

Seen as:

• "That mockup could not be deleted. Try again."
• "That mockup could not be reset. Try again."
• "Those mockups could not be restored. Try again."
• "That section could not be made. Try again."
• "There is already a section called “"
• "Type a name first."
• "Your Photoshop mockups could not be loaded. Try again."

People say: "could not be deleted", "could not be reset", "could not be restored", "section could not be made", "there is already a section called"

Why: These actions need a working connection to ShopPilot. A section name must be typed and must be different from the other section names (capital letters do not make a name different). Only the person who added a mockup can delete or reset it.

Fix:

1. Try the action again once. Reload the page if it keeps failing.
2. For a new section type a name that is not used yet.
3. A team member cannot change a mockup that someone else added; ask that person, or add your own.

Notes: Deleting a mockup does not change listings already made: they keep their photos. Nothing was changed when one of these actions fails.

A run says the PSD mockups are not ready, not selected, or not available for the shop

ID: psd-mockups-run

Seen as:

• "Your PSD mockups are still being prepared. Try again when they are ready."
• "No ready PSD mockups are selected for this shop and section."
• "No ready PSD mockups are selected for this shop."
• "That PSD section is not available for this shop. Choose a section for this shop."
• "Your mockup sections could not be loaded. Try again."
• "Your PSD mockups could not be loaded. Try again."

People say: "No ready PSD mockups are selected", "still being prepared", "that PSD section is not available for this shop"

Why: A run (Create Mockups, or a Curate run that makes mockups) uses the PSD mockups that are ticked for the shop and the section. It stops, and makes nothing, when none of them is ticked, when they are still being prepared, or when the section named for the run is not one of this shop's sections.

Fix:

1. Open "Create Mockups" > "PSD mockups" with the right shop active and tick the mockups the run should use.
2. Wait until the tiles are no longer being prepared.
3. In "Settings" > "Organization" check that the shop is in the section, or choose another section for the run.
4. "could not be loaded. Try again": reload the page and try again.

Notes: Nothing was made or saved when the run stops here, so starting it again is safe.

Rare technical messages (PSD mockups)

ID: psd-mockups-rare

Seen as:

• "a kit image is unreadable"
• "could not encode a kit image"

Why: Internal checks of the prepared mockup's pictures. Nothing was changed.

Fix:

1. Open the mockup with "Change where your design goes" and save it again, or press "Read the PSD again".
2. If it keeps failing, add the PSD again.

If still stuck: contact ShopPilot support with the mockup's name and the exact message.

Not errors: labels and notes (PSD mockups)

ID: psd-mockups-not-errors

Seen as:

• "No. You add the PSD file and Shop Pilot places the designs. Photoshop does not need to be open."
• "What if I don't have PSD files?"
• "Yes. The 5-day free trial needs no card and runs every step on your own shop, with 10 mockup folders a day."
• "Nothing else here to match yet."
• "the Mockups tab. Listings you have already made keep their photos."
• "No PSD mockups yet. Add your PSD files first."

A photo for a room or Smart mockup is refused or cannot be saved

ID: poster-mockups-photo

Seen as:

• "That image could not be decoded."
• "That photo could not be prepared. Try a different file."
• "That photo could not be read. Try uploading it again."
• "That photo is too large. Use one under 60 megapixels."
• "That photo is too small. Its longest side must be at least {…} pixels."
• "That image format cannot be stored."
• "You already have {…} mockup bases. Delete one first."
• "This photo is already one of your mockups. Save your changes to it instead."
• "Your photo could not be saved. Check your storage usage under Account & Privacy, then try again."
• "Your mockup bases could not be loaded. Try again."
• "That mockup base is missing its photo."
• "That photo could not be read."
• "That photo is no longer here."
• "That photo could not be opened for editing. Try again."
• "That photo is too large for this browser to open. Try a"
• "That photo could not be uploaded. You can still mark it by hand."
• "That mockup could not be opened."
• "That photo could not be opened."
• "Drop the photo of your blank first."
• "That photo could not be saved."
• "An info photo has no print area, so there is nothing to cut out."

People say: "photo too small", "photo too large", "that photo could not be read", "you already have mockup bases", "photo is no longer here"

Why: A photo is refused when ShopPilot cannot decode it, when it is smaller than 600 pixels on its longest side, over 60 megapixels, bigger than the upload size limit, or not a JPEG, PNG or WebP. "That photo is too large for this browser to open" means the browser could not open it: use a smaller copy. "That photo is no longer here" means the half-finished mockup (the photo you uploaded for marking) expired and was cleared: upload the photo again. "Your photo could not be saved" and "mockup bases could not be loaded" point to storage or a lost connection. "You already have N mockup bases" means you reached the number of mockups your account may keep.

Fix:

1. Use a sharp JPEG or PNG of the blank product that is at least 600 pixels on the long side and under 60 megapixels (save a smaller copy if it is bigger).
2. If a photo is gone ("no longer here", "could not be opened"), drop it again and mark the corners again.
3. "Check your storage usage under Account & Privacy" (older wording: the storage bar is at the bottom of "Settings"): free some space (delete folders or mockups you no longer need), then try again.
4. "You already have N mockup bases": delete a mockup you no longer use, then save the new one.
5. "This photo is already one of your mockups. Save your changes to it instead.": use the Save button of the open mockup instead of creating a new one.
6. "An info photo has no print area": an info photo has nothing to cut out; use it as it is.

If still stuck: contact ShopPilot support with the photo size in pixels and MB and the exact message.

Notes: Nothing is added to your mockups until you save, so trying again is safe.

My design file for a poster is refused or cannot be made poster-sized

ID: poster-mockups-design

Seen as:

• "That design could not be read."
• "That design could not be read. Try a different file."
• "That design is too large. Use one under 60 megapixels."
• "That design is too small to preview."
• "That file was empty."
• "That design could not be saved. Try again."
• "Could not make the poster design files: {1}"
• "{1} could not be made poster-sized."

People say: "that design could not be read", "design too small to preview", "could not make the poster design files"

Why: A design must be a readable image, not empty, under 60 megapixels and large enough to preview. A phone-shaped design is turned into a poster-sized file at the start of a poster run; that step can fail for an unreadable or damaged file. "That design could not be read." (without "Try a different file") also appears in the "Choose the print design" window of Auto Orders when the picked file cannot be shown.

Fix:

1. Open the design on your computer; if it opens, save a copy as PNG or JPEG and use that.
2. Use a design with enough pixels (at least a few hundred on each side) and under 60 megapixels.
3. Pick another file for the failing design and run again.
4. In "Choose the print design" pick the original artwork file again, or upload a fresh copy.

If still stuck: contact ShopPilot support with the file name, its size and the exact message.

Notes: Nothing was saved for a folder that stopped here, so running it again is safe.

Marking the print area: the corners or edges are refused

ID: poster-mockups-corners

Seen as:

• "Corner coordinates must be numbers."
• "Corners must be on or near the image."
• "Each corner needs an x and a y."
• "That print area is too small to make a mockup from."
• "The edges could not be measured in this photo."
• "No clear edge was found"
• "The outline could not be improved past the straight edges."
• "The edges could not be"
• "The edges could not be measured in this photo. Drag the"
• "The edges could not be measured. Drag the corners to place them"

People say: "corners must be on or near the image", "print area too small", "the edges could not be measured", "no clear edge was found"

Why: The four corners must be placed in order (top left, top right, bottom right, bottom left), on or near the photo, and must not cross each other. A print area that is tiny in the photo is refused. ShopPilot also tries to follow the edges of the print in the photo; on a soft, blurry or very smooth photo it finds no clear edge and asks you to place the corners yourself.

Fix:

1. Click the corners in the order top left, top right, bottom right, bottom left; drag a round dot to move a corner.
2. Zoom in and place each corner on the real corner of the print area; make the area as large as it appears in the photo.
3. "The edges could not be measured": drag the corners to place them yourself, or press "Measure it" again after the photo has finished uploading, or use a sharper photo with the product on a contrasting surface.
4. "The outline could not be improved past the straight edges": keep the straight outline, or drag the square dots to bend an edge by hand.

If still stuck: contact ShopPilot support with the photo and the exact message.

Objects on top: the selection or the cut-out does not work

ID: poster-mockups-cutout

Seen as:

• "Almost none of that object is over the print, so there is nothing for the design to pass behind. Select something that sits on the print itself."
• "Mark something first, then fix its edge."
• "There is nothing marked there."
• "There is nothing selected there."
• "That could not be cleared."
• "That did not go through. Try again."
• "That mark could not be saved. Try again."
• "That mark could not be saved."
• "That could not be undone."
• "There is nothing left to undo here."
• "That cut-out could not be saved. Try again."
• "That outline could not be saved. Try again."
• "Nothing was found there. Try pointing at the object itself."
• "Nothing was found under that stroke."
• "That stroke was empty."
• "That stroke was too small to read."
• "The cut-out model could not run; selected by measurement."
• "Nothing is marked there yet."
• "Nothing marked yet"
• "Nothing was found there"
• "Nothing on the print looked like an object, though a good deal of it was marked and then rejected. Check that the corners are on the blank and not outside it."

People say: "nothing was found there", "that stroke was too small", "nothing selected", "that mark could not be saved"

Why: In the "Objects on top" step you tap or stroke an object that lies on the print so the design passes behind it. A tap finds nothing when it lands on the plain blank, a stroke that is too small or empty cannot be read, and an object that is almost entirely outside the print has nothing to pass behind. "Mark something first, then fix its edge" and "There is nothing marked there" mean no object is marked yet. "The cut-out model could not run; selected by measurement" means ShopPilot used a simpler method; the mark still works.

Fix:

1. Tap the object itself (not the blank around it) or draw a longer stroke across it.
2. For an object only partly on the print, select a part that sits on the print.
3. Use undo to step back ("There is nothing left to undo here" means you are at the start), or clear the marks and start again.
4. "Nothing on the print looked like an object ... Check that the corners are on the blank": go back to "Mark the print area" and put the corners exactly on the blank.
5. If a mark could not be saved, try once more; reload the window if it keeps failing.

Notes: Marks are kept in your open mockup only; nothing reaches your template until you press Save.

A Smart or room mockup could not be saved, renamed, reset or previewed

ID: poster-mockups-save

Seen as:

• "That change could not be saved. Try again."
• "That could not be reset. Try again."
• "That marking could not be reset. Try again."
• "That name could not be saved."
• "That name could not be saved. Check your connection and try again."
• "That name could not be saved. Try again."
• "Nothing was sent to save."
• "Those settings could not be read."
• "Those settings could not be saved. Try again."
• "That preview could not be rendered. Try again."
• "That preview could not be rendered"
• "You have settings saved for too many templates. Reset one to default first."
• "No poster templates yet. Close this and add a room first."
• "Your mockup templates could not be loaded. Close this and try again."
• "Your templates could not be loaded. Close this and try again."
• "That room scene is not available."
• "That mockup could not be saved."
• "That mockup could not be saved. Check your connection and try again."
• "That could not be saved. Check your connection — your changes"
• "That could not be saved. Your changes"
• "The outline could not be saved. Check your connection, then try again."
• "The outline could not be saved. Try again."
• "That preview could not be rendered. Your choices are still here."
• "That preview could not be rendered. Your settings are still here."
• "this and try again in a moment."

People say: "that mockup could not be saved", "the outline could not be saved", "preview could not be rendered", "templates could not be loaded", "the look choices are still loading"

Why: Saving, renaming, resetting and previewing talk to ShopPilot. They fail when the connection dropped, the page is out of date, the account holds settings for too many templates, the server is busy, or the room scene is not available any more. "The look choices are still loading. Close this and try again in a moment." means the look panel had not finished loading. Your choices are kept in the open window, so nothing you set is lost.

Fix:

1. Check your internet connection and press Save again.
2. If you see "You have settings saved for too many templates. Reset one to default first.", open "Edit templates", reset a template you no longer tune, then save.
3. "No poster templates yet. Close this and add a room first.": add a room with "Add custom" first.
4. "Your templates could not be loaded. Close this and try again.": close the window, reload ShopPilot and open it again.
5. If a preview cannot be rendered, change nothing and press the preview again; a busy server usually answers a minute later.

If still stuck: contact ShopPilot support with the exact message and the mockup's name.

Sizes: a size cannot be saved, removed or applied

ID: poster-mockups-sizes

Seen as:

• "A size needs a width and a height, and the two together have to describe a product this can render."
• "A size needs a width and a height, both above zero."
• "You have saved as many sizes as this supports. Delete one you no longer sell first."
• "That size could not be saved. Try again."
• "That size could not be saved."
• "That size could not be saved. Check your connection and try again."
• "That size could not be set."
• "The size was saved, but the mockups using it could not be updated. Try saving it again."
• "That size could not be removed. Try again."

People say: "size could not be saved", "a size needs a width and a height", "you have saved as many sizes as this supports"

Why: A size needs a name and a width and a height that are both above zero and describe a product that can be rendered (not extremely long and thin). The account can keep a limited number of sizes. "The size was saved, but the mockups using it could not be updated" means the size exists but some mockups still carry the old proportions.

Fix:

1. Give the size a name and a width and a height above zero (for example 900 and 400, and the unit).
2. Delete a size you no longer sell, then save the new one.
3. "...could not be updated. Try saving it again.": press Save on the size again.
4. If it keeps failing, check your connection and reload the page.

Notes: Deleting a size does not change mockups that use it; they keep their current proportions.

Storage is full while saving a photo, design or cloth

ID: poster-mockups-storage

Seen as:

• "Storage quota is unavailable."

People say: "storage quota is unavailable"

Why: Your account's storage is full, or the storage check could not run. The same message appears when you pick an original design for an order and when you upload photos for a master listing.

Fix:

1. Look at the storage bar at the bottom of "Settings".
2. Delete folders, mockups or files you no longer need (folders already saved to your PC can be removed from ShopPilot).
3. Try again.

If still stuck: contact ShopPilot support to raise the limit, and say what you were saving.

Rare technical messages (Poster and Smart mockups)

ID: poster-mockups-rare

Seen as:

• "Marking panel missing"
• "Template editor missing"
• "could not decode {…}"
• "could not encode"
• "could not encode a poster mockup"
• "could not encode the preview"
• "could not encode the scene"

Why: Internal checks of the marking window and the picture steps. Nothing was changed.

Fix:

1. Reload ShopPilot (Ctrl+R, or Cmd+R on a Mac) and try once more.
2. If it keeps happening, try another browser window (Chrome).

If still stuck: contact ShopPilot support with the exact message.

Not errors: labels and notes (Poster and Smart mockups)

ID: poster-mockups-not-errors

Seen as:

• "Your wall with an empty picture frame on it, or your desk with"
• "of a blank first."
• "Your photo already shows the product’s real"
• "A photo of the blank product, with nothing printed on it yet and"
• "Nothing on top? Just press Continue."
• "Nothing selected yet. Tap anything standing in front of the print"
• "the list. Nothing reaches your template until you press Save."
• "A photo of the blank product with nothing printed on it yet,"
• "Couldn’t save"
• "Don’t save"

Nothing is added: no files, wrong files or too many

ID: bg-changer-add

Seen as:

• "No files received"
• "No supported image files received"
• "Add images first."
• "Too many files in one background-removal batch (max {…})."
• "Too many files in one processing batch (max {…})."
• "Too many folders in one processing batch (max {…})."
• "Folder has too many files (max {…})."
• "No picture files were found in that folder."
• "Folder is empty"
• "Folder not found"
• "not found"
• "Nothing processed yet"
• "pixel limit"
• "{…} exceeds the {…}-pixel decoded-image limit."
• "{…} image(s) exceed the {…}-pixel decoded-image limit."

People say: "No files received", "no supported image files", "too many files in one batch", "pixel limit", "Folder is empty"

Why: The upload step received no pictures, or only files that are not PNG, JPG or WEBP images. One run takes a limited number of files, folders and files per folder (the message shows the number). A picture bigger than 20 megapixels is refused. A folder without pictures, or one that is gone, cannot be processed. A picture that is no longer in the list (pictures expire after a while) is reported as not found.

Fix:

1. Press "Choose images" (or drop pictures) and pick PNG, JPG or WEBP files.
2. Process fewer files or folders at a time, then do the next batch.
3. Reduce the size of a very large picture (under 20 megapixels) and add it again.
4. Folder mode: add folders that hold pictures; an empty folder shows "Not added, no pictures in it".
5. "not found" or "Nothing processed yet": add the pictures again and press "Process all images" before "Download all as ZIP".

If still stuck: contact ShopPilot support with the number of files and the exact message.

A folder cannot be added or opened

ID: bg-changer-folders

Seen as:

• "All selected folders already added."
• "Add at least one folder first."
• "Rename it first: that name can't be used for a folder"
• "That folder's name cannot be used here. Rename it, then choose it again."
• "Browse error:"
• "Browse failed:"
• "Could not open the folder:"
• "Could not read the folders:"
• "Folder browsing is disabled on the hosted server."
• "Absolute or parent paths are not allowed in hosted mode."
• "Those folders are no longer on ShopPilot. Choose them again."

People say: "can't choose folders", "Browse failed", "rename it first", "those folders are no longer on ShopPilot"

Why: Folders are picked in File Explorer through the Bridge, or dragged in. A folder whose name Windows cannot use for a new folder is refused until you rename it. A folder already in the list is not added twice. The folders you sent are removed from ShopPilot's work area after a while, so an old list says they are no longer there.

Fix:

1. Open the ShopPilot Bridge (and use Chrome) so "Choose folders" opens File Explorer; update the Bridge if it only opens a one-folder window.
2. Rename a folder whose name cannot be used, then choose it again.
3. "Those folders are no longer on ShopPilot": choose the folders again and press "Process all folders".
4. "Add at least one folder first": add a folder before pressing "Process all folders".

Notes: "Folder browsing is disabled on the hosted server" and "Absolute or parent paths are not allowed in hosted mode" mean a folder path was typed or sent in a way the hosted app does not allow; use "Choose folders" instead.

Processing failed, or the server is busy

ID: bg-changer-process

Seen as:

• "Could not prepare images:"
• "Process failed:"
• "Processing failed. Please try again."
• "The request could not be completed. Please try again."
• "The server is busy. Please try again in a minute."
• "The folder could not be saved. Please try again."
• "1 folder failed, see below."
• "The background remover could not start. Try again shortly; if it keeps happening, please contact support."
• "There are already {…} changed copies of this folder. Delete one, then try again."

People say: "Process failed", "the server is busy", "1 folder failed, see below", "changed copies already exist"

Why: A run can fail because the connection dropped, the server is busy (it asks you to wait a minute), a folder could not be written, or the folder already has the maximum number of changed copies.

Fix:

1. Wait a minute and press the same button again; the folders that finished are listed under "Results".
2. "There are already N changed copies of this folder": delete one of the old changed copies (the folders named <folder>_<preset>), then process again.
3. "1 folder failed, see below": the reason is under that folder in "Results"; fix it and process that folder again.
4. "The background remover could not start": wait a moment and try again.

If still stuck: contact ShopPilot support with the folder name and the exact message.

Notes: Processing again is safe: the original folder is never changed.

The message is only "Please try again."

ID: bg-changer-please-try-again

Seen as:

• "Please try again."

People say: "it just says Please try again", "sign-up says please try again"

Why: This short message is a general retry message and is not specific to the Background Changer. The Background Changer's own failures say more ("Processing failed. Please try again.", "The request could not be completed. Please try again."; see the entry above). The bare "Please try again." is also shown at the top of the sign-up form when the form was not accepted this time.

Fix:

1. On the sign-up form: reload the sign-up page, fill in the form again (a valid email, a password of at least 12 characters, accept the legal box) and submit once.
2. If it keeps showing, wait a few minutes and try again, then contact ShopPilot support and say what you were doing.
3. In the Background Changer: press the same button again after a minute; see "Processing failed, or the server is busy".

Notes: Submitting again is safe; nothing is created until the form is accepted.

Saving the new folders to your PC through the Bridge failed

ID: bg-changer-save-pc

Seen as:

• "BG Changer bridge save failed for"
• "bridge save failed"
• "Bridge save failed:"
• "The Bridge could not save the new folder to your PC; it stayed on ShopPilot."
• "The Bridge could not save the new folders to your PC; they stayed on ShopPilot."

People say: "Bridge save failed", "they stayed on ShopPilot"

Why: The new folders are copied to your PC by the Bridge. If the Bridge closed, lost its connection or the shop's folder on your PC is not writable, the new folders stay on ShopPilot (in Create Listings) and nothing is lost.

Fix:

1. Open the Bridge and check it says "Connected".
2. In "Create Listings" select the new folders and press "Save to PC".
3. Or turn on "Save to server" so they stay on ShopPilot.
4. Check the shop's listings folder (set in "Niches") exists on this PC and has free space.

Notes: See the Bridge help for "Saving to your PC or uploading from your PC through the Bridge failed".

Presets: a preset cannot be saved or deleted

ID: bg-changer-presets

Seen as:

• "Enter a name for the preset first."
• "Preset name is required."
• "Missing preset name."
• "Could not save preset:"
• "Save failed:"
• "Delete failed:"
• "colour must be #rrggbb"
• "Nothing saved for this shop yet."
• "Nothing saved for this shop. The default applies."
• "Required for this shop."
• "No shop-specific value saved."

People say: "Enter a name for the preset first", "could not save preset", "colour must be #rrggbb"

Why: A preset needs a name (up to 40 characters) and a colour written as #rrggbb. "Nothing saved for this shop yet" and "No shop-specific value saved" are notes about a shop's own background setting: the default applies until you save one.

Fix:

1. Type a name in the preset box, pick the colour, then press "+ Save preset".
2. Write the colour as six hex characters, for example #f5a0a0.
3. If saving or deleting fails, check your connection and try again.
4. To change a shop's own background colour use the background style on "Create Mockups" (Background swap) for that shop.

Notes: Shop presets (from your shops) cannot be deleted here; only the custom presets you saved can.

Not errors: labels and notes (Background Changer)

ID: bg-changer-not-errors

Seen as:

• "Already in the list"

Prompt Lab did not save

ID: prompt-lab-save

Seen as:

• "Could not reach ShopPilot. Nothing was saved. Check your connection and try again."
• "Save failed."

People say: "nothing was saved", "Save failed", "could not reach ShopPilot", "not saved: switched to another shop or niche"

Why: A change is saved right after you stop typing. It fails when the connection to ShopPilot dropped, when the safety check could not run, when the text was refused by the safety check, when ShopPilot was switched to another shop or niche in another tab or window ("Not saved: ShopPilot was switched ..."), or when the niche was deleted elsewhere. Nothing is saved when it fails.

Fix:

1. Check your internet connection and change the box again (or type one more character) to save.
2. If the page says the niche or shop changed in another tab, reload this page and make the change again.
3. If the safety check refuses a text, read the reason it gives, reword the text and save again.
4. If a message says the safety check could not run (a shared service is unavailable), wait a few minutes and try again; then contact ShopPilot support if it stays.

If still stuck: contact ShopPilot support with the exact message and which box you changed.

Notes: Your old prompt stays in place until a save succeeds.

Presets: a preset cannot be saved, loaded, renamed or deleted

ID: prompt-lab-presets

Seen as:

• "Choose a preset first."
• "No preset selected"
• "That preset could not be loaded. Try again."
• "That preset could not be deleted. Try again."
• "That shop and niche could not be read."
• "That preset could not be saved."
• "That preset could not be deleted."
• "You already have a preset called "{…}"."
• "You already have {…} presets. Delete one first."

People say: "choose a preset first", "that preset could not be loaded", "you already have a preset called", "you already have N presets"

Why: "Update Selected", "Rename" and "Delete" need a preset to be chosen in "Saved Preset" first; choosing one is what loads it. A preset name must be different from your other preset names (capital letters do not make a name different), and an account can keep a limited number of presets. "That shop and niche could not be read" means the shop and niche picked for the import could not be loaded.

Fix:

1. Choose a preset in "Saved Preset", then use "Update Selected", "Rename" or "Delete".
2. Use a name you have not used before; delete a preset you no longer need if the limit is reached.
3. If loading or deleting fails, choose the preset or press the button again once; reload the page if it keeps failing.
4. For the import, pick both a shop and a niche; if it fails, pick them again.

Notes: A preset is the whole page. "Update Selected" replaces the preset with what is on the page now.

Not errors: labels and notes (Prompt Lab)

ID: prompt-lab-not-errors

Seen as:

• "A preset holds this whole page: title mode, template and inspiration title, tag and hashtag counts, emoji, banned words, required keywords, extra instructions and the custom prompt. Presets belong to your account and stay available in every shop and niche. Choosing one fills the boxes below and saves them to this niche straight away."
• "Leave blank to use the built-in prompt. What you type yourself (the title template, inspiration title, extra instructions, banned words, required keywords and the custom prompt) gets a small cached safety check when it changes; normal listing wording is allowed. If that check cannot run, nothing on this page is saved."
• "One per line. At least one must appear naturally in title/tag output."
• "Safety check already approved."

"Blocked by duplicate protection": the folder already has a listing

ID: create-listings-duplicate-protection

Seen as:

• "Blocked by duplicate protection"
• "Duplicate protection blocked"
• "Duplicate protection: {1} already has a recorded listing."
• "Duplicate protection: {1} already have a recorded listing."
• "Already has a recorded {1} listing."
• "{1} for {2}? The existing listing stays exactly as it is - this adds another one alongside it. Duplicate protection is skipped for this run only.{3}"
• "Clear the saved duplicate-protection state for the selected folder(s)?"
• "Could not clear the saved state. Please try again."
• "Failed to clear state"
• "Failed."
• "Pick at least one folder or enter a manual folder first."
• "No saved folder state was found."

People say: "it says duplicate protection", "my folder is blue and won't run", "already has a recorded listing"

Why: ShopPilot keeps a record of every listing it made from each folder, per shop. When a selected folder already has a listing in the shop the run is for (blue folders), it stops so the same design is not listed twice in that shop by accident.

Fix:

1. Want the same design in another of your shops? Duplicate protection is per shop, so do not press "Create draft anyway" or "Publish anyway" (they add a second copy in the SAME shop). Instead press "Change" on the "Listing profile" strip at the top of "Create Listings" and pick the other shop. Check that shop's setup in "Niches" (its listings folder, "Saved master listing", and its own shipping profile, return policy and processing profile under "This shop's Etsy settings"), then select the folder and run it there.
2. Same shop: check your Etsy shop first. Is the listing for that folder already there (as a draft or live)? If yes, nothing needs doing.
3. If you really want a second listing in the same shop from the same folder, press "Create draft anyway" or "Publish anyway" and confirm. The existing listing stays exactly as it is; this adds another one.
4. If the old listing was deleted on Etsy and you want to list the folder as new: select it and use "Advanced tools" > "Clear Duplicate Protection", then run again.

If still stuck: if the folder does not show for the other shop, contact ShopPilot support with both shop names and the folder name.

Notes: The other selected folders still run as normal. Overriding is only for this run.

"No ready folder selected" or the folders don't show

ID: create-listings-no-ready-folder

Seen as:

• "No ready folder selected"
• "The selected folder(s) are already drafted, server-only, or not ready. Select a ready folder to run, or use Save to PC for server-only folders."
• "Listings folder was not found. Check Settings."
• "No listing folders found in the selected local parent folder."
• "Listings folder not found: {…}. Check the Listings Folder Root in Settings."
• "This shop profile's listings folder could not be opened. Please try again, and contact support if it keeps happening."
• "Folder not found: {…}"
• "Folder not found: {…}. If you removed it from the server to free storage, re-upload it from your PC to use it again."
• "{…} has not been uploaded yet, so its images cannot be read. It uploads automatically when a run starts."
• "Invalid folder {…}: {…}"
• "Could not list folders."
• "Could not open the folder: {1}"
• "Could not read the folders: {1}"
• "folder scan failed"
• "Folder rules error - {1}"
• "Could not refresh folders. ShopPilot will retry automatically."
• "Folder refresh failed"
• "Could not read the folders."
• "The folders could not be read."
• "Absolute or parent paths are not allowed."
• "That folder name is not allowed."
• "Folder not found."
• "that folder name is not allowed"

People say: "nothing happens when I press Create", "no folders in Create Listings", "listings folder not found"

Why: Only ready (green) folders run. A folder is not ready when it misses a file the master needs (orange), already has a listing (blue), is only on ShopPilot while working from your PC, or was archived. The list is empty when the shop's listings folder (set in "Niches") is wrong or empty, the Bridge is closed, or the folder was removed from ShopPilot to free storage.

Fix:

1. Open "Niches" and check "This shop's listings folder" for the active shop and niche.
2. Open the Bridge (if your folders are on your PC) and press "Refresh folders".
3. Hover an orange folder to see which file is missing; add it (the file names must match the master's photo slots).
4. For a folder removed from ShopPilot, upload it again from your PC.
5. Select green folders, then press the action again.

If still stuck: see the entry "Mockups missing", "Incomplete folder" or "Filename mismatch" just below.

"Mockups missing", "Incomplete folder" or "Filename mismatch": the folder does not match the master

ID: create-listings-folder-photos

Seen as:

• "Mockups missing -- this folder has no picture from {…} of the mockups the master uses. The master expects: {…}. What to do: tick those mockups on Create Mockups and make the folder again, or open Master Listings and upload the photo you want in those slots."
• "Cannot tell which mockup is meant -- {…}. The master names that photo the way files were named before each mockup kept its own number, and that name fits more than one file here. The master expects: {…}. What to do: open Master Listings and upload the right photo for that slot once (its file name then carries the mockup's own number), or tick only the mockups this shop uses and make the folder again."
• "Incomplete folder -- photos are missing, not misnamed. {…} The master expects: {…}. What to do: re-render this folder's mockups. Renaming will not help; these photos are not in the folder."
• "Incomplete folder -- photos are missing. {…} The master expects: {…}. Files named with a plain number are read as design files, not listing photos: {…}. What to do: if those are your photos, rename them (for example 1.jpg to 01.jpg) and run it again; otherwise re-render this folder's mockups."
• "Filename mismatch -- the photos are here, the names are not. This folder holds {…} unmatched image(s) for {…} empty slot(s), so the shots exist under different names. The master expects: {…}. Unmatched here: {…}. What to do: re-render this folder's mockups so they come out with the standard names, or open Master Listings and set each slot's filename to the file you actually have."
• "Filename mismatch -- the photos are here, the names are not. These files were not named by our mockup generator: {…}. The master expects: {…}. What to do: open Master Listings and upload your own file for each slot, so the master looks for your filenames instead of ours."
• "This folder's only images are named with a plain number ({…}), and ShopPilot reads those as design files, not listing photos. The master expects: {…}. What to do: if they are your photos, rename them (for example 1.jpg to 01.jpg) and run it again; if they are designs, render this folder's mockups."
• "This folder has no listing images in it. The master expects: {…}. What to do: render this folder's mockups, then run it again."
• "Multi-set run failed: {…}" (the folder's reason follows)

People say: "mockups missing", "incomplete folder", "filename mismatch", "the folder is refused", "photos are missing", "the master needs mockups this folder doesn't have"

Why: Every photo slot of the master listing names a file (shown under the photo in "Master Listings" > "Edit" > "Photos"), and a run fills each slot with the folder's file of that name. Before anything goes to Etsy, ShopPilot checks each folder and says which problem it has:

• "Mockups missing": the master's slots are tied to particular mockups (file names like mockup_<number>_<name>.jpg) and this folder was made without them ticked.
• "Incomplete folder -- photos are missing, not misnamed": the folder has fewer photos than the master has slots (for example fewer lifestyle photos than the master's lifestyle slots). Renaming will not help.
• "Filename mismatch": the photos are there, but under other names.
• Files named only with a number (1.png, 2.jpg) are read as design files, not listing photos.
• "Cannot tell which mockup is meant": an older master names a photo in a way that fits more than one file.

Fix:

1. Read the whole message: after "The master expects:" it lists the missing file names.
2. "Mockups missing": open "Create Mockups", tick the mockups with those numbers (each tile shows its number) and make the folder again. Or open "Master Listings" > "Edit" > "Photos", upload the photo you want into those slots and press "Save master listing".
3. "Incomplete folder": make the folder again on "Create Mockups" with enough templates ticked (at least as many lifestyle photos as the master has lifestyle slots).
4. "Filename mismatch": make the folder's mockups again so they get the standard names, or upload your own file into each slot of the master so it looks for your file names.
5. Plain-number files that are really your photos: rename them (for example 1.jpg to 01.jpg).
6. "Cannot tell which mockup is meant": upload the right photo for that slot once in the master, or tick only the mockups this shop uses and make the folder again.
7. Start the run again.

Notes: A refused folder sends nothing to Etsy, so running again is safe.

A run won't start, or ShopPilot is busy

ID: create-listings-run-start

Seen as:

• "Run failed to start"
• "Could not start listings for {1}."
• "This run could not be started. Nothing was created. Please try again."
• "The run could not be started. Nothing was created. Please try again."
• "The run gate refused this slot (HTTP {…})."
• "A run is already in progress."
• "A listing run is already in progress on {…}. Start this one when it finishes."
• "ShopPilot is already running {…} listing runs for everyone together, the most at once. Try again in a few minutes."
• "{…} listing runs are already going in this workspace (the limit is {…}). Start this one when one of them finishes."
• "{…} already has a listing run in progress, started by {…}{…}. Wait for it to finish, or work on another shop."
• "{…} is already being listed by {…} on {…}. Wait for that run to finish."
• "Listing generation could not be started safely on this shop's network route, so nothing was created. Check the proxy under Proxies, then run again."
• "This shop's routing mode must be either Direct or Proxy. Set it in Proxies."
• "Listing generation is not available on this account right now. No listing was created. Please contact support."
• "Temperature must be between 0 and 1. Change it in Settings."

People say: "Run failed to start", "a run is already in progress", "it says try again in a few minutes"

Why: Only one listing run at a time per shop, a folder can't be in two runs at once, and ShopPilot runs a limited number of listing runs at the same time for everyone. A run also can't start when the page lost its connection, the shop's route (Direct/Proxy) is not set or its proxy fails, or listing creation is not available on the account.

Fix:

1. Wait for the running run to finish ("Listing Progress" shows it), or work on another shop.
2. "Try again in a few minutes": ShopPilot is busy; start again shortly.
3. "Could not reach ShopPilot": check your internet and press the action again.
4. Proxy shops: open "Proxies" and press "Test Active Profile Proxy"; fix the proxy or set the shop to Direct.
5. "Temperature must be between 0 and 1": fix that value in "Settings".
6. "Listing generation is not available on this account": contact ShopPilot support.

Notes: When a run did not start, nothing was created, so starting again is safe.

The AI step stopped ("no paid request was sent")

ID: create-listings-ai-step

Seen as:

• "The AI request could not be cost-checked, so no paid request was sent."
• "The AI request could not be cost-checked safely, so no paid request was sent."
• "The AI token counter is temporarily unavailable and this request is too large for ShopPilot's safe fallback, so no paid request was sent."
• "The AI request returned an invalid token count, so no paid request was sent."
• "The AI response could not be accounted for safely. Try again shortly."
• "The AI response omitted required usage accounting; its reservation was retained."
• "ShopPilot is busy recording AI usage, so no paid request was sent. Try again shortly."
• "The AI request attempt could not be reserved safely."
• "The AI request reservation could not be renewed safely."
• "The AI request reservation heartbeat was lost."
• "The AI reservation could not be finalized safely."
• "The AI reservation could not be released safely."
• "The AI response could not be committed exactly once."
• "The prompt review could not be finalized safely."
• "The AI request contains unsupported data."
• "The AI request payload is too large."
• "The AI output limit is invalid."
• "This request exceeds the {…}-token output safety limit."
• "Streaming AI responses are not supported by the accounting guard."
• "The AI service could not be reached."
• "This listing request carries a part the AI route cannot send ({…})."
• "The AI model this account is set to is not available to its key (HTTP 404)."
• "The AI service is rate limiting this key right now (HTTP 429)."
• "The AI service refused its API key (HTTP {…})."
• "The AI service rejected the listing request (HTTP {…})."
• "The AI service's key is on a free plan that allows only a few requests a minute, so it refused this one (HTTP 429)."

People say: "AI request could not be cost-checked", "no paid request was sent", "AI service is rate limiting"

Why: ShopPilot's AI writes the listing copy. Before each AI request ShopPilot checks it safely; if that check or the AI service is not available for a moment, it stops the folder without sending anything, so nothing is charged and no half listing is made.

Fix:

1. Wait a few minutes and run the folder again.
2. If it keeps happening for an hour or more, contact ShopPilot support with the time and the exact message.

Notes: Running again is safe: the stopped folder made no Etsy listing.

Custom prompt or AI copy problems

ID: create-listings-ai-copy

Seen as:

• "This request contains {…} input tokens; the server safety limit is {…}. Shorten the custom prompt."
• "The editable prompt controls are too large for the listing workflow."
• "The custom prompt safety check could not finish, so the listing model was not called. Try again shortly."
• "The custom prompt safety check returned an invalid result, so no listing request was sent. Try again shortly."
• "This custom prompt is paused pending administrator review."
• "This custom prompt is already being checked. Wait a moment and save again."
• "Too many different custom prompts were submitted for AI review in the last 24 hours. Existing approved prompts still work."
• "AI listing creation is temporarily paused for this account until {…} because repeated prompt/output safety checks were triggered. The administrator can review the encrypted evidence."
• "ai_title must be a complete standalone title without template placeholders."
• "design_name ({…}) + style ({…}) = {…} chars, exceeds {…}-char budget by {…}. Shorten style first (drop its least searched word), then design_name."
• "design_name and style must be strings"
• "design_name must not be empty"
• "hashtags must be an array"
• "hashtags must contain exactly {…} valid item(s); got {…}."
• "intro_paragraph missing or too short"
• "None of the required keywords appeared naturally in design_name, style, or variable_tags:"
• "None of the required keywords appeared naturally in design_name, style, or variable_tags: {…}"
• "variable_tags must be an array"
• "variable_tags must contain exactly {…} valid item(s); got {…}. Raw tags: {…}. Dropped: {…}. Return exactly {…} unique candidate tags, each 1-20 characters."
• "{…} duplicate of {…}"
• "{…} invalid/over 20 chars"
• "{…} must be an array of up to {…} values."
• "Validation failed after {…} repair rounds: {…}"
• "recognized_identity must be 60 characters or fewer"
• "recognized_identity must be a JSON string"

People say: "the custom prompt is paused", "required keywords did not appear", "validation failed"

Why: The AI's copy must pass checks before it is used: a full title without placeholders, the right number of tags (each at most 20 characters, no duplicates), hashtags, an opening paragraph, and your required keywords. ShopPilot asks the AI to fix its copy a few times; if it still fails, the folder stops. A custom prompt in "Prompt Lab" is checked for safety before use; a very long one, or many new prompts in a day, can be refused or paused for review.

Fix:

1. In "Prompt Lab", shorten the custom prompt and the extra rules, or press to use the built-in prompt (leave the custom prompt empty).
2. If required keywords did not appear: use fewer or more general required keywords.
3. If the title is too long: shorten the title template or style words in "Prompt Lab".
4. Press "Preview Copy" on one folder to check, then run the batch.
5. "This custom prompt is paused pending administrator review." or "AI listing creation is temporarily paused for this account until ...": wait until the time it names, or contact ShopPilot support.

Notes: A folder that failed these checks made no listing; running it again is safe.

Etsy refused the listing, or Etsy had a problem

ID: create-listings-etsy-refused

Seen as:

• "Etsy rejected this listing - {…}: {…} What to do: correct the {…} on the master (Master Listings) or in Niches, then run the folder again."
• "Etsy rejected this listing: {…} This shop has no processing profile chosen. What to do: open Niches, choose Refresh under this shop's Etsy settings, pick a processing profile and save, then run the folder again."
• "Etsy rejected this listing: {…} What to do: correct that on the master (Master Listings) or in Niches, then run the folder again."
• "Etsy refused to create this listing, which normally means the shop itself is not cleared to sell yet - setup unfinished, suspended, or under review. A production partner is chosen, so that is not the cause."
• "Etsy rejected the listing text because it uses a character Etsy limits - most often more than one '&'."
• "Etsy could not find this shop, or one of the shop settings this run sent belongs to a different shop."
• "Etsy is rate-limiting this shop."
• "Etsy refused this shop's connection."
• "Etsy rejected the request (HTTP {…})."
• "Etsy's API returned a server error, so this one is on Etsy's side."
• "Retry the folder in a few minutes. Nothing here needs changing."
• "The listing could not be finished on Etsy."
• "This folder could not be listed."
• "This folder could not be previewed."
• "Error:"
• "The run stopped before any listing was made."

People say: "Etsy rejected this listing", "Etsy is rate-limiting this shop", "Etsy refused this shop's connection"

Why: Etsy checks every listing. Common reasons: a field on the master that Etsy does not accept (the message names it and says what to do), no processing profile for this shop, a character Etsy limits (most often more than one "&"), the shop's Etsy connection was refused (connect again), Etsy is limiting how fast this shop can make listings, an Etsy server error, or the Etsy shop itself is not cleared to sell yet (setup unfinished, under review or suspended).

Fix:

1. Read "What to do" in the message and fix that on the master ("Master Listings" > "Edit") or in "Niches".
2. "refused this shop's connection": connect the shop again in "Connect Etsy".
3. "rate-limiting" or "server error": wait a few minutes and run the folder again; nothing needs changing.
4. "not cleared to sell": finish your shop setup on Etsy or ask Etsy support; ShopPilot can't change it.
5. Run the failed folders again.

Notes: A folder Etsy refused usually made no listing. If the message says the listing could not be finished, check your Etsy drafts before running it again.

The run stops before Etsy: master or niche setup problem

ID: create-listings-setup-stop

Seen as:

• "Template description is missing required markers: {…}. Update the master Etsy template before running."
• "The description is missing"
• "The saved master listing could not be read. Open Niches and re-pick the master for this niche."
• "This niche has no master listing. Open Niches, choose a saved master from your library, and save -- every run reads its photos, category, variations and base copy from it."
• "This niche has no processing profile chosen for this shop, and Etsy refuses a listing without one. Open Niches, choose Refresh under this shop's Etsy settings, pick a processing profile and save."
• "This niche has no saved master listing yet, so its description cannot be checked. Choose a saved master on the niche first."
• "This niche has no saved master listing. Open Niches, choose one from your library, and save."
• "This niche's image-to-variation connections could not be read. Open Niches and connect the images again."
• "The master's saved photo filenames are invalid. Open Niches and save the niche again."
• "The master's variation ranks are invalid. Open Niches and save the niche again."
• "The saved variation filename rule uses unsupported regex syntax. Open Settings and save it as a filename template containing {n}."
• "The variation filename template is too long."
• "Variation filenames must be a safe filename template containing one {n}."
• "Variation filenames must contain exactly one numeric {n} placeholder."
• "Variation filenames must use a literal template containing {n}."

People say: "description is missing required markers", "this niche has no master listing"

Why: Before anything goes to Etsy, the run checks the niche's master and setup: a saved master must be chosen, the shop needs a processing profile, and the variation file name rule must be valid (one {n}).

Fix:

1. Follow the steps in the master listings section: "The niche has no master, or the master can't be read or isn't ready" and "A run is refused: no shipping profile, return policy or processing profile".
2. Variation file name rule: write it as a file name with exactly one {n} (for example design_{n}.png) in "Settings", or leave it empty.
3. "Open Niches and save the niche again": open the niche and choose its master again.

Draft limit or trial listing limit reached

ID: create-listings-limits

Seen as:

• "This shop already has {…} unpublished {…} on Etsy. ShopPilot creates new drafts only while a shop has fewer than {…}. Publish or delete some drafts (Draft Review in Registry does both), or use Create + Publish Live."
• "This shop has {…} unpublished {…} on Etsy and the limit is {…}, so only {…} more {…} can be created now. Select {…} or fewer folders, publish or delete some drafts, or use Create + Publish Live."
• "Free trial listing limit reached."
• "Access limit: {1} of {2} listings left in this window. Slots shrink to fit."

People say: "it says the shop already has unpublished drafts", "trial listing limit reached"

Why: ShopPilot makes new Etsy drafts only while the shop has fewer unpublished drafts than a set number, so drafts don't pile up (the message says the numbers). A free trial has a daily listing limit.

Fix:

1. Open "Review Drafts" (or "Registry" > Draft Review), publish or delete drafts you don't need, then run again.
2. Or select fewer folders, as the message says, or use "Create + Publish Live".
3. Trial: wait for the daily limit to reset (midnight in your time zone) or choose a plan (https://shoppilot.dev/pricing).

Stopping a run: what happened to the listing

ID: create-listings-stop-run

Seen as:

• "The listing it was publishing may already be live: check it on Etsy."
• "The unfinished draft it had started could not be removed"
• "You stopped this run. Nothing was published: the Etsy draft it had made may still be in your shop as an unpublished draft (check your drafts on Etsy)."
• "You stopped this run before a listing was made on Etsy."
• "You stopped the run after this listing was saved as a draft."
• "You stopped the run after this listing went live."
• "Folders it had not reached were not started."
• "Not done: the run was stopped."
• "Stopped here."
• "Folders the run has not reached are not started."
• "Listings it has already finished stay as they are.</p>"
• "Listings it has already finished stay as they are."
• "ShopPilot stops the run straight away. Nothing more is published."
• "The run could not be stopped. It may already have finished."
• "Run stopped - {1}"
• "Folder {1} stopped: {2}"
• "You stopped the listing run for {1}."
• "The run stopped before it finished (exit code {1})."
• "Listings for {1} stopped with exit code {2}."
• "Listing run stopped"
• "The listing run stopped."
• "Nothing after this step was done."
• "{1} folders failed, see below."
• "{1} folder{2} saved · {3} failed"

People say: "I stopped the run, is there a half listing on Etsy?", "the run stopped with exit code"

Why: "Stop run" stops at once. Finished listings stay. ShopPilot removes the listing it was in the middle of from Etsy. When it could not remove it, the message says so: an unfinished draft may still be in your shop, or the listing it was publishing may already be live. A run can also stop on its own (exit code) when something failed.

Fix:

1. Read the stop note on "Listing Progress".
2. "may still be in your shop as an unpublished draft": open your Etsy drafts and delete it.
3. "may already be live": check the listing on Etsy; delete it there if you don't want it.
4. Run the folders that were not reached again. Folders that finished are blue and protected against duplicates.
5. "The run could not be stopped": it may already have finished; refresh "Listing Progress".

Notes: Check Etsy before re-running a folder that was in progress when you stopped, so you don't list it twice.

Deleting folders from ShopPilot

ID: create-listings-delete-folders

Seen as:

• "Could not reach the server to delete those folders."
• "The server could not delete those folders. Please try again."
• "It stays on the server: save it to your PC first, then delete it from the server."
• "One live listing is from a shop you have disconnected from ShopPilot. Nothing in ShopPilot"
• "Save it to PC first"
• "They stay on the server: save them to your PC first, then delete them from the server."
• "This listing is live on Etsy and is not saved on your PC. Save it to your PC first, then remove it from the server."
• "One live listing is from a shop you have disconnected from ShopPilot. Nothing in ShopPilot uses it any more, so it can go even without a copy on your PC."
• "{1} live listings are from shops you have disconnected from ShopPilot. Nothing in ShopPilot uses those any more, so they can go even without a copy on your PC."
• "{1} live Etsy listings were kept on the server: save them to your PC first."
• "Save to PC first"
• "Auto Orders can’t find the print file."

People say: "can't delete the folder from the server", "it says save it to your PC first"

Why: "Delete from server" removes folders from your ShopPilot storage (never from your PC). A folder of a listing that is live on Etsy is kept until it is saved on your PC, because Auto Orders needs its print file. Folders of shops you disconnected can go without a copy.

Fix:

1. Select the folder and press "Save to PC" first (the Bridge must be open).
2. Then press "Delete from server" again.
3. "Could not reach the server": check your connection and try again.

Uploading folders fails

ID: create-listings-upload

Seen as:

• "could not be saved"
• "Duplicate path in request."
• "Mismatched files/paths count."
• "No valid files were received."
• "that file name is not allowed"
• "Your upload could not be saved. Check your storage usage under Account & Privacy, then try again."
• "Folder {1} upload {2} failed: {3}"
• "The folders could not be uploaded, so their"
• "Not added, rename it first (that name can't be used for a folder): {1}."
• "There are already 3 changed copies of this folder. Delete one, then try again."
• "Folder download exceeds the 500-file or 1 GB archive limit."

People say: "upload failed", "No valid files were received", "your upload could not be saved"

Why: Uploads need image files (jpg, png, webp...) in folders with names a folder can have. They fail when your storage is full, a file or folder name is not allowed, the same file comes twice, the connection drops, or a download is bigger than one archive can hold (500 files or 1 GB).

Fix:

1. Check your storage (the bar at the bottom of "Settings") and free space if it is full.
2. Rename folders or files with unusual characters (use letters, numbers, - and _).
3. Upload fewer folders at a time.
4. "There are already 3 changed copies of this folder": delete one, then try again.

Review Drafts: publishing or deleting drafts fails

ID: create-listings-draft-review

Seen as:

• "Draft action failed"
• "Draft action failed."
• "Select at least one draft first."
• "Draft review actions are limited to 100 listings at a time."
• "Publish-all is disabled. Open Registry > Draft Review and select the drafts to publish."
• "Disabled safety stub. Use Registry > Draft Review to publish selected drafts."

People say: "Draft action failed", "publish all doesn't work"

Why: Draft Review publishes or deletes only the drafts you select, at most 100 at a time. There is no button that publishes every draft at once, on purpose. An action fails when a draft was changed or deleted on Etsy meanwhile, or Etsy refused it.

Fix:

1. Select at least one draft (up to 100) and try again.
2. Reload the list if drafts were changed on Etsy.
3. If Etsy refused a draft, open it on Etsy to see what is missing.

Bulk Edit: a change is refused or fails

ID: create-listings-bulk-edit

Seen as:

• "Bulk edit failed"
• "Lost contact with ShopPilot part-way through this edit."
• "Price and variation changes need a preview first. Building one now…"
• "This writes to Etsy immediately and cannot be undone from here."
• "— first error:"
• "Could not build a preview"
• "Select at least one listing first."
• "Every selected listing already has it."
• "No {1} that every selected listing has."
• "A cut of 100% or more would leave nothing to charge."
• "Could not read this listing's inventory from Etsy."
• "Description cannot be blank."
• "Etsy accepts only active or inactive here. A published listing cannot be moved back to draft."
• "Tags cannot be blank."
• "Title cannot be blank."
• "{…} material(s) skipped: already at Etsy's {…}-material cap"
• "{…} tag(s) skipped: already at Etsy's {…}-tag cap"
• "A listing needs at least one model."
• "A model name cannot be blank."
• "Etsy allows {…} values on one variation. Remove {…} more first."
• "The model list could not be read. Reload the page and try again."
• ""{…}" is already a value on this listing."
• "Refusing: the rebuilt inventory lost a product."
• "A product on this listing has no single {…} value, so its models cannot be rebuilt safely."
• "That would leave this listing with nothing to sell."
• ""{…}" was already there, so "{…}" was removed"
• "A material on this listing is no longer on Etsy's list; remove it first."
• "Etsy does not accept {…} in {…}. Take it out and try again."
• "Etsy refuses a title in which more than three words start with two capital letters ({…}). Write some of them in lower case."
• "Etsy refused the title: more than three words in it start with two capital letters. Write some of them in lower case."
• "Etsy refused the title"
• "That listing could not be updated."
• "Etsy request failed."
• "Etsy request failed ({…})."
• "Find text cannot be blank."
• "Refusing a price of {…}: outside the {…}-{…} range this panel will write."
• "Price editing is not available on this build."
• "Etsy did not send the saved variations back, so the new order could not be checked."

People say: "Bulk edit failed", "Etsy refused the title", "tag cap", "price edit refused"

Why: Bulk Edit writes straight to your live Etsy listings, so it refuses changes Etsy would reject or that would break a listing: a blank title, description or tags; more tags (13) or materials than Etsy allows; a title where more than three words start with two capital letters; characters Etsy does not accept; a price cut of 100% or more; removing every model from a listing; moving a published listing back to draft. A connection drop part-way leaves some listings changed and others not.

Fix:

1. Read the reason in the message and change the edit (for example write some title words in lower case).
2. For price and variation edits, press "Preview changes" first, check the before and after, then "Apply these changes".
3. After a lost connection: "Sync from Etsy" again to see which listings changed, then apply to the rest.

Notes: Edits cannot be undone from ShopPilot. Preview first, and check the first small batch on Etsy before the rest.

Settings switches and the shop's PC folder can't be saved

ID: create-listings-settings

Seen as:

• "Auto-archive could not be changed. Please try again."
• "Auto-upscale could not be saved. Try again."
• "Could not load Settings. Please try again."
• "No folder was chosen."
• "The folder could not be saved for this shop."
• "The folder could not be saved."

People say: "Auto-archive won't switch", "could not save the folder for this shop"

Why: The page lost its connection for a moment, or no folder was chosen in the folder window.

Fix:

1. Reload the page and change the switch again.
2. Choose the folder again (the Bridge must be open).

Niches: ShopPilot could not work out a folder's file names

ID: create-listings-folder-analysis

Seen as:

• "ShopPilot could not find a shared numbered variation series. Name the files with a common number, such as variation_1.jpg, variation_2.jpg, and try again."
• "ShopPilot found the variation series but could not identify a separate main image."
• "AI vision was unavailable, so ShopPilot used its filename-pattern detector."
• "The visual preview could not be created, so ShopPilot used its filename-pattern detector."

People say: "could not find a shared numbered variation series"

Why: When you let ShopPilot look at an example listing folder, it looks for a main image and a numbered series of variation images (for example variation_1.jpg, variation_2.jpg). It stops when the files have no shared numbered name, or when it can't tell which file is the main image. When the picture check is not available, it uses the file names only.

Fix:

1. Name the variation images with one shared name and a number (variation_1.jpg, variation_2.jpg...).
2. Give the main image a different name (for example main.jpg).
3. Run the check again, or set the names by hand.

Rare technical messages (Create Listings)

ID: create-listings-rare

Seen as:

• "{…} people are already watching live logs, the most at once. Your log keeps going and shows up when you reopen this page."
• "Something went wrong. Try again."
• "ShopPilot did not reach the server. Try again in a minute."
• "The listing was not changed. Try again in a minute."
• "OAuth flow failed"
• "Etsy not connected"

Why: A short problem while ShopPilot or Etsy answered, or too many people watching live logs at once. Nothing was created.

Fix:

1. Reload the page and try again.
2. "people are already watching live logs": your run keeps going; reopen "Listing Progress" later to see it.
3. "OAuth flow failed" or "Etsy not connected": connect the shop again in "Connect Etsy".

If still stuck: contact ShopPilot support with the exact message and the time.

Not errors: labels and notes (Create Listings)

ID: create-listings-not-errors

Seen as:

• "Batch: stop after first failed folder (default: continue)"
• "Override duplicate protection: list a folder again even if the registry already records a listing for it"
• "Clears the duplicate-protection record for the selected folders, so ShopPilot will list them again as if they were new. It does not change your folder selection or your files."
• "Green = ready. Orange = needs files. Blue = already drafted."
• "needs attention."
• "needs review ·"
• "Select every folder that has all required images and isn't already uploaded"
• "Shows which file lands in which Etsy gallery slot for the selected folders. Reads only: it creates nothing and contacts Etsy for nothing."
• "When ON, the whole batch stops as soon as any folder fails. When OFF, problems are skipped and the rest keep running."
• "are required; a run is refused without them and says which is missing. A"
• "No {{INTRO}} in the description: the AI opening goes at the top."
• "please try again from Create Listings."
• "(local only — not yet on the server)"
• "already drafted"
• "All {1} selected folder{2} already on the server — skipping upload."
• "Folder {1}/{2}: design files already uploaded — skipping upload."
• "Action required"
• "Stopped by you"
• "You stopped this run."
• "This step needs attention."
• "Warnings"
• "Expired"
• "Newest listed first"
• "Oldest listed first"
• "No title saved yet"
• "Nothing synced yet"
• "Nothing matches."
• "Don’t add it to this listing"
• "Each time you open Create Listings, you choose the shop these listings are for. Nothing can be previewed, drafted or published until you do. Pick it here, or choose Next to look around first."
• "First, confirm the shop"