ShopPilot help for AI assistants › topic

The public website (shoppilot.dev)

This is one topic of ShopPilot's help for AI assistants. The whole help, with every topic: https://shoppilot.dev/docs. Each message is shown in English, with the Latvian (LV) and Russian (RU) text the app shows.

Instructions for AI assistants

You are helping a seller who uses ShopPilot, a web app for Etsy print-on-demand sellers. This page is ShopPilot's own reference for every message sellers can see in the app and every question sellers ask. Use it as your source of truth for anything about ShopPilot.

  1. Find out what happened. Ask for the exact message (copied text or a screenshot), the page or tab they were on, what they pressed just before, Windows or Mac, which browser, and which shop if they run several. A trial or a paid plan matters for limits.
  2. Find the entry. Search this page for the exact message. Parts in {…} or {1} are filled in at run time (a shop name, a number, a file name), so match on the fixed words around them. The app also runs in Latvian and Russian: the message index pages give every message in all three languages with the entry it belongs to. If you cannot open them, translate the message and match it by meaning.
  3. Answer with the entry. Follow its "Fix" steps in order and use the on-screen names exactly. If the seller uses the app in Latvian or Russian, give the names in their language too (see the glossary). Answer in the seller's language.
  4. Safety. Never ask for or accept a password, the full ShopPilot key (it starts with SP-), Etsy login details, or a supplier (Alerio, Gelato) login or API key. If the seller already pasted one into the chat, tell them to treat it as exposed: change a password right away, and for a ShopPilot key email support@shoppilot.dev with the subject SECURITY. You cannot look into a seller's account. Take the retry warnings seriously: some actions can make a duplicate Etsy listing or a duplicate supplier order.
  5. Hand over to a person when an entry says "Contact ShopPilot support", for payments and billing questions about a specific charge, a lost key or account access, anything that looks like a security problem, or when nothing on this page matches. Tell the seller what to send (see "Contact ShopPilot support").
  6. Do not guess. If this page does not cover it, say so and point the seller to support. Do not invent buttons, settings, limits or prices. For prices and plans, link https://shoppilot.dev/pricing. Every page, tab and button a seller can use is named in this page's "How it works" lists and "Fix" steps. Only send the seller to places named there. Do not build a step from the words of an error message: if a message names a place that this page does not describe, do not send the seller there.
  7. Etsy decides Etsy things. ShopPilot cannot change Etsy's decisions (shop suspensions, removed listings, fees, payouts, Etsy account settings). Send those to Etsy's own help.

Contact ShopPilot support

How it works

Problems and errors

The activation key box says "Enter your activation key.", "Unable to connect that key." or "Network error. Try again."

ID: site-activation-key-box

Seen as:

  • "Network error. Try again."
  • "Unable to connect that key."
  • "Enter your activation key."

People say: "unable to connect that key", "enter your activation key", "network error on the key box", "the dashboard asks for a key", "my key does not work", "the key box says error"

Why: The box asks for a ShopPilot activation key (it looks like SP-XXXX-XXXX-XXXX-XXXX). "Enter your activation key." means the box was empty. "Unable to connect that key." means ShopPilot did not accept the key and gave no more detail; when it does give a reason the box shows that instead, for example "This activation key is already in use by another account.", "This account already has an activation key. Disconnect it before linking another key.", "That is a team member key, not a ShopPilot licence. Team members sign in at /team/login." or "Unable to link that key. Wait and try again or contact support." (too many tries in a short time). "Network error. Try again." means the browser could not reach ShopPilot. The key box is only for people who already own a key; a person who just signed up does not need one.

Fix:

  1. New to ShopPilot: close the box, log in at https://shoppilot.dev/login, open the account page and press "Start free trial". The trial key is created for you and shown there and in your email.
  2. Already have a key: log in first, open the account page, go to the "Activation Key" tab, paste the whole key, tick the Terms and Privacy box (in the key window) and press the button. Keys are not case-sensitive. Team members log in with their team key at the team login page instead of adding it as a licence.
  3. Network error: check the internet connection, reload the page and try once more.
  4. "Already in use by another account", "This account already has an activation key" or an expired or revoked key: contact ShopPilot support with your account email and the reason shown (a renewal or a key change is needed; see https://shoppilot.dev/pricing).
  5. "Wait and try again": wait a few minutes before the next try.

If still stuck: contact ShopPilot support with the account email (never the full key in a group chat).

Notes: Trying a wrong key does no harm. A key already linked to another account cannot be used on a second account.

"Article not found" or "Not found" on the website (a blog link or page that does not exist)

ID: site-not-found

Seen as:

  • "Not found"

People say: "article not found", "that article does not exist", "blog link doesn't work"

Why: The address does not match any article or page. Blog links are lower case and look like https://shoppilot.dev/blog/<article-name>; a link copied from an old message, or cut short, shows "Article not found. That article does not exist." with a "See all articles" button.

Fix:

  1. Press "See all articles" (or open https://shoppilot.dev/blog) and pick the article from the list.
  2. For a page of the app, use https://shoppilot.dev/app after logging in.

If still stuck: tell ShopPilot support the address that failed.

The Etsy tag and title checker shows "Not allowed", "Over 20 characters" or "Nothing to fix"

ID: site-tag-checker

Seen as:

  • "Not allowed:"
  • "Nothing to fix"
  • "Etsy tag and title checker by Shop Pilot: a title and 13 tags checked against Etsy&#x27;s limits"
  • "Free Etsy tag and title checker: tests a listing title and 13 tags against Etsy's limits and its 2026 advice."
  • "Etsy's current pages give no rule either way. What Etsy does advise: no near-duplicate tags, no tags that only repeat your category or attributes, and phrases buyers actually search for."
  • "Up to 140 characters. Etsy's current guidance suggests fewer than 15 words, with the most important words first, because search engines show only about the first 50 to 60 characters."
  • "Over 20 characters"
  • "One word: a phrase says more"
  • "Same as “"

People say: "tag checker says not allowed", "over 20 characters", "same as", "one word: a phrase says more", "nothing to fix"

Why: https://shoppilot.dev/etsy-tag-checker tests a title and up to 13 tags against Etsy's rules as you type; it never contacts Etsy. For the title: up to 140 characters; letters, numbers, punctuation, math symbols, spaces and the marks (tm), (c) and (R) are accepted; each of % : & + may appear only once; Etsy suggests fewer than 15 words with the key words first, no repeated words, no price or sale wording and no stacked "gift" phrases. For tags: at most 13; each at most 20 characters ("Over 20 characters"); letters, numbers and spaces ("Not allowed: ..." lists the characters Etsy won't take); an apostrophe or hyphen cannot come first; duplicates are marked; "Same as "{tag}" to Etsy (plurals match)" means Etsy treats the two as one; "One word: a phrase says more" is advice, not an error. "Nothing to fix" means no check failed; "N to check" are suggestions.

Fix:

  1. Shorten or replace any tag over 20 characters and remove characters the checker lists.
  2. Remove duplicates and near-duplicates (plural and singular count as the same).
  3. Use multi-word phrases buyers search for.

Notes: These are Etsy's published limits and advice; Etsy decides what a listing accepts. Etsy's current pages give no rule about some of the advice, and the checker says so.

Cannot log in, sign up or confirm the email code

ID: site-login-signup

Seen as:

  • "Email or password is incorrect."
  • "Your login took too long. Log in again."
  • "Your email isn't confirmed yet. Use the code or the button from the email we sent."
  • "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. Check the address and request a new code."

People say: "I can't log in", "wrong password", "I forgot my password", "I never got the code", "the code does not work", "email not confirmed", "log in says incorrect"

Why: Logging in uses the email and password of the ShopPilot account made at https://shoppilot.dev/signup. A ShopPilot key alone does not log you in, and a key that is linked to an email account cannot be used to log in directly. Team members have their own page ("Log in with your team key"). "Email or password is incorrect." means a typo, a different email address than the one used at sign-up, or an account that was never created. After sign-up the email must be confirmed with the 6-digit code or the button in the email; until then the app says "Your email isn't confirmed yet." A code works only from one of the two most recent emails and expires after a while. "Your login took too long" and "This login form expired" mean the login page was left open too long. After several wrong passwords or codes the page makes you wait ("Too many ... You can try again in about N minutes.").

Fix:

  1. Retype the email and password (the "Show" link next to the password lets you check it). If you forgot the password, press "Forgot password?" on the login page, enter your account email and follow the link in the email; then log in with the new password.
  2. For the sign-up code: open the newest email from ShopPilot (look in the spam or junk folder too), type the 6-digit code in the same browser where you signed up, or press the button in the email. If the code expired, ask for another one on the same page.
  3. If the email address was mistyped at sign-up ("The verification email could not be sent"), sign up again with the right address.
  4. After many wrong tries wait for the time the page shows before trying again.

If still stuck: contact ShopPilot support with the email address you used (never the password).

Notes: A password has at least 12 characters. Nothing is charged for creating an account.

Rare technical messages (website)

ID: site-rare

Why: The public pages have no technical messages of their own beyond the ones above.

Fix:

  1. Reload the page.

If still stuck: contact ShopPilot support with the address of the page and what you saw.

Not errors: marketing texts and answers on the public pages

ID: site-not-errors

Seen as:

  • "Are duplicate tags added twice?"
  • "No. When you add tags to many listings, duplicates are skipped."
  • "Does my computer need to be on?"
  • "No. Folders that are already listed are marked, so the same listing does not go up twice by mistake."
  • "Yes. Press Create + Publish Live to post now, or Create Draft to check it on Etsy first."
  • "Yes. The 5-day free trial needs no card and includes 10 listings a day, posted now or scheduled."
  • "Doesn't Etsy have bulk editing already?"
  • "Etsy's own Listings Manager can change some fields on many listings at once, such as titles, tags, descriptions, prices and shipping profiles. Bulk Edit adds what a print-on-demand shop needs on top: swapping phone models inside the variations of every listing that has them, and a before-and-after preview of every listing before anything saves."
  • "No. Every item is tracked on its own, and an order that may already be in your cart is locked, so it is never sent twice."
  • "Yes. The 5-day free trial needs no card and sends up to 5 real orders a day to your supplier. You pay the supplier for them."
  • "Auto Orders: an order ready to go to the Alerio cart, with orders already sent to Alerio and in production behind it"
  • "Yes. The 5-day free trial needs no card and includes 10 listings a day, posted now or scheduled, on your own shop."
  • "The unfinished listing is taken off Etsy and the finished ones stay. Folders that are already listed are marked, so the same listing does not go up twice."
  • "Yes. The 5-day free trial needs no card and includes 10 listings a day on your own shop."
  • "Yes. Paste phone models in bulk and give each one its own price if you need to."
  • "Yes. A master listing works across every shop you run, with sections and shipping profiles filled in per shop. Duplicate it when one shop needs a change."
  • "Yes. The 5-day free trial needs no card and includes 10 bulk edits on your own shop."
  • "The 5-day free trial needs no card and lets you connect up to 3 Etsy shops."
  • "Yes. Etsy allows more than one shop, each on its own Etsy account with its own email address, and each account's public profile has to list every shop. Duplicate shops made to get around Etsy's rules are not allowed. Shop Pilot then runs all your shops from one login."
  • "Yes. One master listing or writing style can serve many shops. Duplicate it when one shop needs a change. Sections and shipping profiles are filled in per shop."
  • "Create Mockups, poster templates: the artwork on its own and room scenes with an empty frame"
  • "Pick the folders. Shop Pilot writes the title, 13 tags and description, and fills in prices, shipping and all 70 phone models from that shop's setup. About 37 seconds a listing. Post live, or save drafts to check first."
  • "How to bulk edit Etsy listings: what Etsy can and can't do"
  • "What Etsy's Listings Manager can change on many listings at once, how to use it step by step, what it can't do, and when a bulk edit tool with a preview helps."

Common questions

Q: Do I need my computer on for the Listing Scheduler?

A: No. The Listing Scheduler posts for you at the times you choose, and the server makes the listings. Folders that are already listed are marked, so the same listing does not go up twice by mistake.

Q: Can I post a listing straight away instead of scheduling it?

A: Yes. Press "Create + Publish Live" to post now, or "Create Draft" to check it on Etsy first.

Q: What happens if I stop a run halfway?

A: The unfinished listing is taken off Etsy and the finished ones stay. Folders that are already listed are marked, so the same listing does not go up twice.

Q: Can an order be sent to the supplier twice?

A: No. Every item is tracked on its own, and an order that may already be in your Alerio cart is locked, so it is never sent twice. Nothing is paid in ShopPilot; you pay the supplier.

Q: Are duplicate tags added twice when I bulk edit?

A: No. When you add tags to many listings, duplicates are skipped.

Q: Doesn't Etsy have bulk editing already?

A: Etsy's Listings Manager can change some fields on many listings at once (titles, tags, descriptions, prices, shipping profiles). Bulk Edit adds what a print-on-demand shop needs: swapping phone models inside the variations of every listing that has them, and a before-and-after preview of every listing before anything saves.

Q: Can I give each phone model its own price?

A: Yes. Paste phone models in bulk and give each one its own price if you need to.

Q: Can one master listing serve several shops?

A: Yes. A master listing or writing style works across every shop you run, with sections and shipping profiles filled in per shop. Duplicate it when one shop needs a change.

Q: Can one person have several Etsy shops?

A: Etsy allows more than one shop, each on its own Etsy account with its own email address, and each account's public profile has to list every shop. Duplicate shops made to get around Etsy's rules are not allowed. ShopPilot then runs all your shops from one login. The free trial connects up to 3 shops.

Q: Is everything included in the free trial?

A: The 5-day free trial needs no card and has daily limits for listings, mockups, Curate and orders and fixed limits for bulk edits and shops (see https://shoppilot.dev/free-trial). Some tools, such as Market Research, are part of the paid plans only.

Q: I did not get my 6-digit sign-up code. What do I do?

A: Check the spam or junk folder and the address you typed. Use the code or the button in the email, in the same browser where you signed up. If it still does not arrive, contact ShopPilot support with the email address you used.

Q: Do I have to accept the analytics cookies in the cookie banner?

A: No. "Reject" is fine. It only affects visit statistics; logging in and using the app work either way.

Q: Where do I cancel or see my payments?

A: On the account page, open "Subscription & Payments" and press "Cancel subscription"; the payment provider opens and you confirm there. The plan then works until the end of the period you paid for. See https://shoppilot.dev/refunds.

Q: Is ShopPilot part of Etsy?

A: No. It is an independent tool that uses Etsy's official API and is not made, endorsed or certified by Etsy.