ShopPilot help for AI assistants › topic

Niches and master listings

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

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."
    LV: "Šī niša veido sludinājumus no saglabāta galvenā sludinājuma, bet šim veikalam nav izvēlēts piegādes profils. Atveriet Nišas, sadaļā Šī veikala Etsy iestatījumi nospiediet Atsvaidzināt un izvēlieties to."
    RU: "Эта ниша работает с сохранённым мастер-листингом, но для этого магазина не выбран профиль доставки. Откройте «Ниши», в разделе «Настройки Etsy этого магазина» нажмите «Обновить» и выберите его."
  • "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."
    LV: "Šī niša veido sludinājumus no saglabāta galvenā sludinājuma, bet šim veikalam nav izvēlēts apstrādes profils, un bez tā Etsy sludinājumu nepieņem. Atveriet Nišas, sadaļā Šī veikala Etsy iestatījumi nospiediet Atsvaidzināt, izvēlieties apstrādes profilu un saglabājiet."
    RU: "Эта ниша работает с сохранённым мастер-листингом, но для этого магазина не выбран профиль обработки, а без него Etsy не принимает листинг. Откройте «Ниши», в разделе «Настройки Etsy этого магазина» нажмите «Обновить», выберите профиль обработки и сохраните."
  • "This niche builds from a saved master but has no return policy chosen for this shop. Open Niches and pick one."
    LV: "Šī niša veido sludinājumus no saglabāta galvenā sludinājuma, bet šim veikalam nav izvēlēta atgriešanas politika. Atveriet Nišas un izvēlieties to."
    RU: "Эта ниша работает с сохранённым мастер-листингом, но для этого магазина не выбраны правила возврата. Откройте «Ниши» и выберите их."
  • "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."
    LV: "Šīs nišas piegādes profils un atgriešanas politika tika izvēlēti citam veikalam, tāpēc Etsy noraidītu katru šīs palaišanas sludinājumu. Atveriet Nišas, sadaļā Šī veikala Etsy iestatījumi nospiediet Atsvaidzināt un izvēlieties tos vēlreiz."
    RU: "Профиль доставки и правила возврата этой ниши выбраны для другого магазина, поэтому Etsy отклонит каждый листинг этого запуска. Откройте «Ниши», в разделе «Настройки Etsy этого магазина» нажмите «Обновить» и выберите их заново."
  • "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."
    LV: "Neizdevās nolasīt šī veikala Etsy iestatījumus."
    RU: "Не удалось прочитать настройки Etsy этого магазина."
  • "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."
    LV: "Saglabātam galvenajam sludinājumam nav sava piegādes profila, atgriešanas politikas vai apstrādes profila, tāpēc izvēlieties šī veikala iestatījumus, un palaišana netiks noraidīta. Viss šeit saglabājas automātiski."
    RU: "У сохранённого мастер-листинга нет собственного профиля доставки, политики возврата или профиля обработки, поэтому выберите их для этого магазина — и запуск не будет отклонён. Всё здесь сохраняется автоматически."
  • "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)"
    LV: "… (neizdevās nolasīt jūsu galveno sludinājumu bibliotēku — atveriet "Galvenie sludinājumi")"
    RU: "… (не удалось прочитать библиотеку мастер-листингов — откройте «Мастер-листинги»)"
  • "{1} has no saved master listing for {2}, so its folders can’t be checked. Each shop needs its own."
    LV: "{1} nav saglabāta galvenā sludinājuma nišai {2}, tāpēc tā mapes nevar pārbaudīt. Katram veikalam vajag savu."
    RU: "У {1} нет сохранённого мастер-листинга для ниши {2}, поэтому его папки нельзя проверить. Каждому магазину нужен свой."
  • "“{1}” is not filled in yet, so a run can't use it. {2} Open Master Listings and press Edit on it."
    LV: "“{1}” vēl nav aizpildīts, tāpēc palaišana to nevar izmantot. {2} Atveriet Galvenie sludinājumi un pie tā nospiediet Rediģēt."
    RU: "«{1}» ещё не заполнен, поэтому запуск не может его использовать. {2} Откройте «Мастер-листинги» и нажмите у него «Изменить»."
  • "This master cannot run yet."
    LV: "Šo galveno sludinājumu vēl nevar palaist."
    RU: "Этот мастер-листинг пока нельзя запустить."
  • "This master’s description is missing"
    LV: "Šī galvenā sludinājuma aprakstā trūkst"
    RU: "В описании этого мастер-листинга не хватает"
  • "The description is missing {…}."
  • "No saved masters yet."
    LV: "Saglabātu galveno sludinājumu vēl nav."
    RU: "Сохранённых мастер-листингов пока нет."
  • "Could not load the master listing library."
    LV: "Neizdevās ielādēt galveno sludinājumu bibliotēku."
    RU: "Не удалось загрузить библиотеку мастер-листингов."
  • "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."
    LV: "Šai nišai vēl nav galvenā sludinājuma. Atveriet Nišas, izvēlieties saglabātu galveno sludinājumu no savas bibliotēkas un saglabājiet: katra palaišana no tā ņem fotoattēlus, kategoriju, variācijas un pamata tekstu."
    RU: "У этой ниши пока нет мастер-листинга. Откройте «Ниши», выберите сохранённый мастер-листинг из своей библиотеки и сохраните: каждый запуск берёт из него фото, категорию, вариации и базовый текст."
  • "“{1}” is not ready to run yet. {2} Open Master Listings and press Edit on it."
    LV: "“{1}” vēl nav gatavs palaišanai. {2} Atveriet Galvenie sludinājumi un pie tā nospiediet Rediģēt."
    RU: "«{1}» ещё не готов к запуску. {2} Откройте «Мастер-листинги» и нажмите у него «Изменить»."

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"
    LV: "Katrā sludinājuma mapē jābūt failam ar šo nosaukumu"
    RU: "В каждой папке листинга должен быть файл с этим именем"
  • "Cannot carry a variation photo."
    LV: "Nevar saturēt variācijas foto."
    RU: "Не может содержать фото вариации."
  • "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."
    LV: "Šim galvenajam sludinājumam nav variāciju, tāpēc foto nevar tām piesaistīt."
    RU: "У этого мастер-листинга нет вариаций, поэтому фото нельзя к ним привязать."
  • "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."
    LV: "Viss šeit saglabājas automātiski, tiklīdz to maināt. Katrā sludinājuma mapē jābūt failam katram galvenā sludinājuma foto faila nosaukumam; šie faili aizpilda galerijas vietas. Viss pārējais mapē paliek neizmantots."
    RU: "Всё здесь сохраняется само, как только вы это меняете. В каждой папке листинга должен быть файл для каждого имени фото мастер-листинга; эти файлы заполняют места в галерее. Всё остальное в папке не используется."

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."
    LV: "Neizdevās augšupielādēt šo foto."
    RU: "Не удалось загрузить это фото."
  • "Could not add that photo."
    LV: "Neizdevās pievienot šo foto."
    RU: "Не удалось добавить это фото."
  • "Could not remove that photo."
  • "The master listing image set is too large."
  • "The master’s {1} photo could not be read."
    LV: "Neizdevās nolasīt galvenā sludinājuma fotoattēlu “{1}”."
    RU: "Не удалось прочитать фото мастер-листинга «{1}»."
  • "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."
    LV: "Variāciju faila nosaukuma veidne nedrīkst beigties ar punktu vai atstarpi."
    RU: "Шаблон имени файла вариации не может заканчиваться точкой или пробелом."
  • "The variation filename template contains a character that filenames cannot use."
    LV: "Variāciju faila nosaukuma veidnē ir rakstzīme, ko failu nosaukumos nevar izmantot."
    RU: "Шаблон имени файла вариации содержит символ, недопустимый в именах файлов."
  • "The variation filename template must be 200 characters or fewer."
    LV: "Variāciju faila nosaukuma veidnē drīkst būt ne vairāk kā 200 rakstzīmes."
    RU: "Шаблон имени файла вариации должен быть не длиннее 200 символов."
  • "Choose this shop's listings folder first."
    LV: "Vispirms izvēlieties šī veikala sludinājumu mapi."
    RU: "Сначала выберите папку листингов этого магазина."
  • "Could not save niche setup"
    LV: "Nevarēja saglabāt nišas iestatījumus"
    RU: "Не удалось сохранить настройки ниши"
  • "Could not save the folder and master. Check both and try again."
    LV: "Neizdevās saglabāt mapi un galveno sludinājumu. Pārbaudiet abus un mēģiniet vēlreiz."
    RU: "Не удалось сохранить папку и мастер-листинг. Проверьте оба и попробуйте снова."
  • "Could not save this niche."
    LV: "Neizdevās saglabāt šo nišu."
    RU: "Не удалось сохранить эту нишу."
  • "Could not save niche setup."
    LV: "Nevarēja saglabāt nišas iestatījumus."
    RU: "Не удалось сохранить настройки ниши."
  • "Listings folder location is invalid or too long."
  • "Could not open the folder picker."
    LV: "Neizdevās atvērt mapes izvēli."
    RU: "Не удалось открыть выбор папки."
  • "No folder was selected."
    LV: "Mape netika izvēlēta."
    RU: "Папка не выбрана."
  • "Could not analyze folder"
    LV: "Nevarēja analizēt mapi"
    RU: "Не удалось проанализировать папку"
  • "ShopPilot could not analyze that folder."
    LV: "ShopPilot nevarēja analizēt šo mapi."
    RU: "ShopPilot не удалось проанализировать эту папку."

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."
    LV: "Vispirms ierakstiet lodziņā produkta veidu, piemēram, Wall Art, tad nospiediet Pievienot nišu."
    RU: "Сначала впишите в поле тип товара, например Wall Art, затем нажмите «Добавить нишу»."
  • "That niche already exists."
  • "Could not create niche"
    LV: "Nevarēja izveidot nišu"
    RU: "Не удалось создать нишу"
  • "Could not delete niche"
    LV: "Nevarēja izdzēst nišu"
    RU: "Не удалось удалить нишу"
  • "Phone Cases is the built-in default and cannot be deleted."
  • "Could not switch niche"
    LV: "Nevarēja pārslēgt nišu"
    RU: "Не удалось сменить нишу"
  • "Niche not found."
  • "Could not load niche profiles. Using Phone Cases for now."
    LV: "Nevarēja ielādēt nišu profilus. Pagaidām tiek izmantota niša Phone Cases."
    RU: "Не удалось загрузить профили ниш. Пока используется ниша «Phone Cases»."
  • "Could not load niches"
    LV: "Nevarēja ielādēt nišas"
    RU: "Не удалось загрузить ниши"
  • "loadNiches failed"
    LV: "loadNiches neizdevās"
    RU: "Ошибка loadNiches"
  • "Could not save preference"
    LV: "Neizdevās saglabāt iestatījumu"
    RU: "Не удалось сохранить настройку"
  • "Could not save the niche guide preference"
    LV: "Neizdevās saglabāt nišas ceļveža iestatījumu"
    RU: "Не удалось сохранить настройку руководства по нише"

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."
    LV: "Neizdevās saglabāt šo Etsy sludinājumu kā galveno."
    RU: "Не удалось сохранить этот листинг Etsy как мастер-листинг."
  • "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."
    LV: "Etsy vienā variācijā atļauj ne vairāk kā {1} modeļus. Vispirms noņemiet vienu, tad pievienojiet jauno modeli."
    RU: "Etsy допускает в одной вариации не больше {1} моделей. Сначала удалите одну, затем добавьте новую модель."
  • "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."
    LV: "Neizdevās saglabāt šo galveno sludinājumu."
    RU: "Не удалось сохранить этот мастер-листинг."
  • "could not be saved."
    LV: "neizdevās saglabāt."
    RU: "не удалось сохранить."
  • "Could not save the master listing."
    LV: "Neizdevās saglabāt galveno sludinājumu."
    RU: "Не удалось сохранить мастер-листинг."
  • "Could not load this master listing."
    LV: "Neizdevās ielādēt šo galveno sludinājumu."
    RU: "Не удалось загрузить этот мастер-листинг."
  • "Could not load categories."
    LV: "Neizdevās ielādēt kategorijas."
    RU: "Не удалось загрузить категории."
  • "Could not load this category’s options."
    LV: "Neizdevās ielādēt šīs kategorijas opcijas."
    RU: "Не удалось загрузить параметры этой категории."
  • "Could not save the category."
    LV: "Neizdevās saglabāt kategoriju."
    RU: "Не удалось сохранить категорию."
  • "Could not add the starter master."
    LV: "Neizdevās pievienot sākuma galveno sludinājumu."
    RU: "Не удалось добавить стартовый мастер-листинг."
  • "Could not create a blank master."
    LV: "Neizdevās izveidot tukšu galveno sludinājumu."
    RU: "Не удалось создать пустой мастер-листинг."
  • "Could not copy the master listing."
    LV: "Neizdevās nokopēt galveno sludinājumu."
    RU: "Не удалось скопировать мастер-листинг."
  • "That master is too large to copy safely."
  • "Could not remove the master listing."
  • "Could not load master listings."
    LV: "Neizdevās ielādēt galvenos sludinājumus."
    RU: "Не удалось загрузить мастер-листинги."
  • "Could not prepare this master listing."
    LV: "Neizdevās sagatavot šo galveno sludinājumu."
    RU: "Не удалось подготовить этот мастер-листинг."

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."
    LV: "Neizdevās izveidot sludinājuma melnrakstu."
    RU: "Не удалось создать черновик листинга."
  • "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."
    LV: "Neizdevās ielādēt jūsu sludinājumus."
    RU: "Не удалось загрузить ваши листинги."
  • "Could not load your listings. Please try again."
    LV: "Neizdevās ielādēt jūsu sludinājumus. Lūdzu, mēģiniet vēlreiz."
    RU: "Не удалось загрузить ваши листинги. Попробуйте ещё раз."
  • "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"
    LV: "Priekšskatījums nav atrasts"
    RU: "Предпросмотр не найден"
  • "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."
    LV: "Dzēst {1} no Etsy? To nevar atsaukt. Reģistrā paliks ieraksts par dzēšanu."
    RU: "Удалить {1} с Etsy? Это нельзя отменить. В реестре останется запись об удалении."

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."
    LV: "Neizdevās mainīt iestatījumu “Saglabāt serverī”. Lūdzu, mēģiniet vēlreiz."
    RU: "Не удалось изменить «Сохранять на сервере». Попробуйте ещё раз."
  • "Save to server is on. Try again."
    LV: "“Saglabāt serverī” ir ieslēgts. Mēģiniet vēlreiz."
    RU: "«Сохранять на сервере» включено. Попробуйте снова."

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."
    LV: "Neizdevās ielādēt maketu redaktora failu."
    RU: "Не удалось загрузить файл редактора мокапов."
  • "That master listing request could not be completed. Nothing was changed. Please try again."
  • "Master listing request failed."
    LV: "Galvenā sludinājuma pieprasījums neizdevās."
    RU: "Запрос мастер-листинга не выполнен."
  • "the print service could not produce mockup template {1}."
    LV: "drukas serviss nevarēja izveidot maketa veidni {1}."
    RU: "сервис печати не смог создать шаблон мокапа {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."
    LV: "Šo vietu nosauc mūsu maketu ģenerators. Tā izveidotās mapes jau atbilst."
    RU: "Этот слот именует наш генератор мокапов. Созданные им папки уже подходят."
  • "Don't show again for this niche"
    LV: "Vairs nerādīt šai nišai"
    RU: "Больше не показывать для этой ниши"
  • "Required"
    LV: "Obligāti"
    RU: "Обязательно"
  • "If your designs are already in the selected folder, you can now create listings for this shop."
    LV: "Ja jūsu dizaini jau ir izvēlētajā mapē, tagad varat izveidot sludinājumus šim veikalam."
    RU: "Если ваши дизайны уже в выбранной папке, теперь можно создавать листинги для этого магазина."
  • "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."
    LV: "Jūsu pievienotās nišas varat iestatīt paši. Veikala īpašnieka nišas ir kopīgas visai komandai, tāpēc to mainīšanai vajadzīga īpašnieka atļauja."
    RU: "Добавленные вами ниши вы настраиваете сами. Ниши владельца магазина общие для всей команды, поэтому для их изменения нужно разрешение владельца."
  • "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."
    LV: "Katra palaišana ņem kategoriju, galeriju, variācijas un pamata tekstu no galvenā sludinājuma. "Izvēlēties" atver jūsu bibliotēku, kur varat izvēlēties kādu vai pievienot iebūvēto telefonu vāciņu sākuma veidni — nevienam no tiem nekas nav vajadzīgs Etsy. Lai izmantotu kādu savu Etsy sludinājumu, pievienojiet to sadaļā Galvenie sludinājumi ar "Pievienot no Etsy"."
    RU: "Каждый запуск берёт категорию, галерею, вариации и базовый текст из мастер-листинга. «Выбрать» открывает вашу библиотеку, где можно выбрать мастер или добавить встроенный стартовый шаблон для чехлов — ни тому, ни другому ничего не нужно на Etsy. Чтобы использовать свой листинг Etsy, добавьте его в разделе «Мастер-листинги» кнопкой «Добавить с 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."
    LV: "Katra palaišana ņem kategoriju, galeriju, variācijas un pamata tekstu no šeit izvēlētā galvenā sludinājuma, un nekam no tā nav jābūt Etsy. Ja sarakstā nekas neder, pievienojiet iebūvēto telefonu vāciņu sākuma veidni ar pogu šī loga apakšā."
    RU: "Каждый запуск берёт категорию, галерею, вариации и базовый текст из мастер-листинга, выбранного здесь, и ничего из этого не обязано быть на Etsy. Если в списке ничего не подходит, добавьте встроенный стартовый шаблон для чехлов кнопкой внизу этого окна."
  • "Each pair has its own price, as on Etsy. An empty price uses the Price above. Untick Visible to stop selling a pair."
    LV: "Katram pārim ir sava cena, kā Etsy. Tukša cena izmanto augstāk norādīto cenu. Noņemiet atzīmi “Redzams”, lai pārtrauktu pāra pārdošanu."
    RU: "У каждой пары своя цена, как на Etsy. Если цена пустая, используется цена выше. Снимите галочку «Видимо», чтобы перестать продавать пару."
  • "Select the wording it should replace, then pick a marker. With nothing selected it drops in at the cursor."
    LV: "Iezīmējiet tekstu, ko tam jāaizstāj, tad izvēlieties marķieri. Ja nekas nav iezīmēts, tas tiek ievietots kursora vietā."
    RU: "Выделите текст, который нужно заменить, затем выберите метку. Если ничего не выделено, она вставится в позицию курсора."
  • "Nothing here."
    LV: "Šeit nekā nav."
    RU: "Здесь ничего нет."
  • "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."
    LV: "Atstājiet tukšu, lai izmantotu iebūvēto uzvedni. Tam, ko ierakstāt paši (nosaukuma veidne, 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: "Оставьте пустым, чтобы использовать встроенный промпт. То, что вы вводите сами (шаблон заголовка, дополнительные инструкции, запрещённые слова, обязательные ключевые слова и свой промпт), при изменении проходит небольшую кэшируемую проверку безопасности; обычный текст листинга разрешён. Если проверку выполнить не удаётся, ничего на этой странице не сохраняется."
  • "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"
    LV: "Apstrādes laiks, piegādes noteikumi, atgriešanas noteikumi, biežākie jautājumi… Piemērs: - Apstrāde: 2–3 darba dienas - Piegāde: ar izsekošanu, 5–10 dienas - Saņēmāt nepareizu maciņu? Atsūtiet foto — salabosim bez maksas"
    RU: "Срок обработки, условия доставки, условия возврата, частые вопросы… Пример: - Обработка: 2–3 рабочих дня - Доставка: с отслеживанием, 5–10 дней - Пришёл не тот чехол? Пришлите фото — исправим бесплатно"

Common questions

Q: What is a master listing?

A: The listing you build once in "Master Listings". Every run copies it and only fills in the photos from the folder and the AI-written title, opening and hashtags.

Q: Do I need a master listing on Etsy?

A: No. Masters live in ShopPilot. "Add from Etsy" copies one of your listings once, but you can also start from the built-in phone-case master or a blank one.

Q: Why does every shop need its own shipping profile and return policy?

A: Etsy keeps them per shop, and a listing must use the selling shop's own. Pick them for each shop in "Niches" under "This shop's Etsy settings".

Q: Can one master serve several shops?

A: Yes. Choose it on the niche of each shop. To change it for one shop only, "Duplicate" it and choose the copy there.

Q: If I edit the master, do my existing listings change?

A: No. Changes reach future runs only. Listings already on Etsy stay as they are.

Q: How does ShopPilot know which photo goes where?

A: By file name. The file name under each slot in the master's "Photos" tab must exist in each listing folder.

Q: My folder has more images than the master. Is that a problem?

A: No. Only the files the master names are used; the rest stay in the folder.

Q: What does "Forget" in the Registry do?

A: It removes ShopPilot's record only. Nothing changes on Etsy.