ShopPilot help for AI assistants › topic

Prompt Lab

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.

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.
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.
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.
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.
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").
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.
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

Email: support@shoppilot.dev
Phone: +371 20307020 (call or text)
Discord: bnb.vilna or metinatajs1
WhatsApp community: the "WhatsApp community" link in the app and on https://shoppilot.dev/support. Other sellers answer quick questions there too.
Send: your account email, the exact message (or a screenshot), what you did just before, which shop, Windows or Mac, and which browser.
Never send: your password, your full ShopPilot key, or the login details for Etsy or your supplier.
Security problems: email support@shoppilot.dev with the subject SECURITY. Say when it happened, which account, and what you saw. If a password or key got out, change it right away.
Privacy requests (export your data, disconnect Etsy, delete your account): "Account & Privacy" in the app.

How it works

"Prompt Lab" (left menu, Setup) controls how ShopPilot's AI writes the titles, descriptions, tags and hashtags of your listings. The settings belong to ONE niche of ONE shop: the page names the niche it is editing, so a prompt tuned for phone cases does not touch another niche.
There is no Save button: every change saves by itself and the page shows "Saved". Changes affect future copy only; listings already on Etsy are not touched.
"Presets" hold the whole page (title mode, template and inspiration title, tag and hashtag counts, emoji, banned words, required keywords, extra instructions and the custom prompt). They belong to your account and are available in every shop and niche. Use "Save Page As New Preset", "Update Selected", "Rename" and "Delete". Choosing a preset in "Saved Preset" loads it straight away: it fills the boxes and saves them to the current niche (a "Put back the previous prompt" link undoes it). "Import from another shop or niche" does the same with the prompt page of another shop and niche: pick a shop and a niche and their page fills the boxes.
"Title Generation": "Title Mode" is "Use title template" (the title follows your template) or "Use complete AI-generated title". The AI writes both versions every run and the mode decides which one goes to Etsy. The "Title Template" must contain {design_name} and {style}, for example "{design_name} Phone Case {style} Cover for ...". An Etsy title can be at most 140 characters.
"Inspiration title": paste one of your own titles. New titles follow its style and length, not its words. "Add from Etsy" fills it in with an imported listing's title while it is empty.
"Prompt Controls": "Extra Instructions" (short rules added to the prompt), "Tags" (how many search tags the AI writes: 1 to 13, default 4; your own master-listing tags come first), "Hashtags" (how many hashtags are added to the description footer, default 3), "Emoji in Descriptions" ("Do not use emoji" or "Allow a couple in the description"), "Banned Words / Phrases" (one per line; never used in the title, tags, description or hashtags) and "Required Keywords" (one per line; at least one appears naturally in the title or tags).
Etsy does not accept emoji in a title, a tag or a material, so any that reach those are removed before the listing is sent.
"Prompt Version": "Built-in Prompt" shows the prompt ShopPilot uses. "Custom Override" replaces it; blank means the built-in prompt is used. "Copy Built-in to Editable Prompt" puts a copy in the box to edit, and "Clear Override" returns to the built-in prompt. You may copy the built-in prompt into another AI chat to reword it; keep the structure the box tells you to keep (the exact output fields and the parts ShopPilot fills in on every run), then paste the result into "Custom Override".
Always press "Preview Selected Folder" on one folder before a large batch, to see the real title, tags and attributes it would produce.
Safety check: what you type yourself (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 the check cannot run, nothing on the page is saved and the page says so.

Problems and errors

Prompt Lab did not save

ID: prompt-lab-save

Seen as:

"Could not reach ShopPilot. Nothing was saved. Check your connection and try again."
LV: "Neizdevās sazināties ar ShopPilot. Nekas netika saglabāts. Pārbaudiet savienojumu un mēģiniet vēlreiz."
RU: "Не удалось связаться с ShopPilot. Ничего не сохранено. Проверьте подключение и попробуйте ещё раз."
"Save failed."
LV: "Saglabāšana neizdevās."
RU: "Не удалось сохранить."

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:

Check your internet connection and change the box again (or type one more character) to save.
If the page says the niche or shop changed in another tab, reload this page and make the change again.
If the safety check refuses a text, read the reason it gives, reword the text and save again.
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."
LV: "Vispirms izvēlieties sagatavi."
RU: "Сначала выберите пресет."
"No preset selected"
LV: "Nav izvēlēta sagatave"
RU: "Пресет не выбран"
"That preset could not be loaded. Try again."
LV: "Šo sagatavi neizdevās ielādēt. Mēģiniet vēlreiz."
RU: "Не удалось загрузить этот пресет. Попробуйте снова."
"That preset could not be deleted. Try again."
LV: "Šo sagatavi neizdevās izdzēst. Mēģiniet vēlreiz."
RU: "Не удалось удалить этот шаблон. Попробуйте ещё раз."
"That shop and niche could not be read."
LV: "Šo veikalu un nišu neizdevās nolasīt."
RU: "Не удалось прочитать этот магазин и нишу."
"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:

Choose a preset in "Saved Preset", then use "Update Selected", "Rename" or "Delete".
Use a name you have not used before; delete a preset you no longer need if the limit is reached.
If loading or deleting fails, choose the preset or press the button again once; reload the page if it keeps failing.
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."
LV: "Sagatave satur visu šo lapu: nosaukuma režīmu, veidni un iedvesmas nosaukumu, tagu un tēmturu skaitu, emocijzīmes, aizliegtos vārdus, obligātos atslēgvārdus, papildu norādījumus un pielāgoto uzvedni. Sagataves pieder jūsu kontam un ir pieejamas katrā veikalā un nišā. Izvēloties sagatavi, tā aizpilda laukus zemāk un uzreiz saglabā tos šai nišai."
RU: "Пресет хранит всю эту страницу: режим и шаблон заголовка, заголовок-образец, количество тегов и хэштегов, эмодзи, запрещённые слова, обязательные ключевые слова, дополнительные инструкции и свой промпт. Пресеты принадлежат вашему аккаунту и доступны в каждом магазине и нише. Выбранный пресет заполняет поля ниже и сразу сохраняет их для этой ниши."
"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."
LV: "Atstājiet tukšu, lai izmantotu iebūvēto uzvedni. Tam, ko ierakstāt paši (nosaukuma veidne, iedvesmas nosaukums, papildu norādījumi, aizliegtie vārdi, obligātie atslēgvārdi un pielāgotā uzvedne), pēc izmaiņām tiek veikta neliela, kešota drošības pārbaude; parasts sludinājumu teksts ir atļauts. Ja pārbaudi nevar veikt, nekas šajā lapā netiek saglabāts."
RU: "Оставьте пустым, чтобы использовать встроенный промпт. То, что вы вводите сами (шаблон заголовка, заголовок-образец, дополнительные инструкции, запрещённые слова, обязательные ключевые слова и свой промпт), при изменении проходит небольшую кэшируемую проверку безопасности; обычный текст листинга разрешён. Если проверку выполнить не удаётся, ничего на этой странице не сохраняется."
"One per line. At least one must appear naturally in title/tag output."
LV: "Pa vienam katrā rindā. Vismaz vienam dabiski jāparādās nosaukumā vai tagos."
RU: "По одному в строке. Хотя бы один должен естественно появиться в заголовке или тегах."
"Safety check already approved."
LV: "Drošības pārbaude jau apstiprināta."
RU: "Проверка безопасности уже одобрена."

Common questions

Q: What does Prompt Lab change?

A: How ShopPilot's AI writes the title, description, tags and hashtags of new listings for the niche that is open. It does not change listings that are already on Etsy.

Q: Where is the Save button?

A: There is none. Every change saves by itself and the page shows "Saved". If it cannot save, it says so.

Q: What is the difference between the title template and the AI title?

A: With the template, the title follows your pattern and the AI fills in the design name and style. With the complete AI title, the AI writes the whole title. Both are written every run and the "Title Mode" decides which goes to Etsy.

Q: How do I stop a word from appearing in my listings?

A: Put it in "Banned Words / Phrases", one per line. The AI never uses it in the title, tags, description or hashtags.

Q: How do I make sure a keyword is used?

A: Put it in "Required Keywords", one per line. At least one of them appears naturally in the title or tags.

Q: How many tags does the AI write?

A: You choose, from 1 to 13 (the default is 4). Tags from your master listing come first and the AI adds its own.

Q: Can I use emoji in the description?

A: Yes, if you choose "Allow a couple in the description". Etsy does not accept emoji in a title, a tag or a material, so they are removed there.

Q: Can I reuse my prompt in another shop or niche?

A: Yes. Save the page as a preset (presets belong to your account), or use "Import from another shop or niche".

Q: How do I go back to the built-in prompt?

A: Press "Clear Override", or empty the "Custom Override" box. A blank box means the built-in prompt is used.

Q: How can I see what the AI will write before a big run?

A: Press "Preview Selected Folder" on one folder. It shows the real title, tags and attributes for that folder.

Q: Why does a change take effect only on new listings?

A: The text is written when a listing is made. Listings already created keep their wording.