Create Mockups (phone cases and design files)

"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."
  LV: "Dizaina attēli vēl nav izvēlēti. Ievelciet tos augstāk esošajā lodziņā “Izvēlēties dizaina attēlus” vai tajā nospiediet Pārlūkot."
  RU: "Изображения дизайнов ещё не выбраны. Перетащите их в поле «Выбрать изображения дизайнов» выше или нажмите в нём «Обзор»."
• "Select at least one mockup template"
  LV: "Izvēlieties vismaz vienu maketa veidni"
  RU: "Выберите хотя бы один шаблон мокапа"

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."
  LV: "iegultajiem oriģināliem, pēc tam mēģiniet vēlreiz."
  RU: "встроенных оригиналов, затем попробуйте ещё раз."
• "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"
  LV: "Neizdevās saglabāt dizainu mapi"
  RU: "Не удалось сохранить папку с дизайнами"

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}"
  LV: "Automātiskā sagatavošana neizdevās: {1}"
  RU: "Автоподготовка не удалась: {1}"
• "Could not prepare batch {1} ({2})."
  LV: "Neizdevās sagatavot paketi {1} ({2})."
  RU: "Не удалось подготовить пакет {1} ({2})."
• "Could not be prepared"
  LV: "Neizdevās sagatavot"
  RU: "Не удалось подготовить"
• "Set "{1}" prep failed: {2}"
  LV: "Komplekta "{1}" sagatavošana neizdevās: {2}"
  RU: "Не удалось подготовить набор «{1}»: {2}"
• "Folder {1}/{2} ("{3}") stopped before mockups: {4}"
  LV: "Mape {1}/{2} ("{3}") apturēta pirms maketiem: {4}"
  RU: "Папка {1}/{2} («{3}») остановлена до мокапов: {4}"
• "Folder {1}/{2} ("{3}") stopped: no usable prepared designs."
  LV: "Mape {1}/{2} ("{3}") apturēta: nav derīgu sagatavotu dizainu."
  RU: "Папка {1}/{2} («{3}») остановлена: нет подходящих подготовленных дизайнов."
• "Mockups finished with problems — {1} folder{2} ready, {3} set{4} failed."
  LV: "Maketi pabeigti ar problēmām — gatavas mapes: {1}, neizdevušies komplekti: {3}."
  RU: "Мокапы готовы с ошибками — готово папок: {1}, не удалось наборов: {3}."
• "Mockups finished with problems"
  LV: "Maketi pabeigti ar problēmām"
  RU: "Мокапы готовы, но с проблемами"
• "{1} set{2} failed — see Mockups progress"
  LV: "Neizdevušies komplekti: {1} — skatiet maketu progresu"
  RU: "Наборов с ошибкой: {1} — см. ход создания мокапов"
• "Nothing was saved for this folder, so you can fix the cause and run it again."
  LV: "Šai mapei nekas netika saglabāts, tāpēc varat novērst cēloni un palaist to vēlreiz."
  RU: "Для этой папки ничего не сохранено, поэтому можно устранить причину и запустить её снова."
• "Opened the mockup workspace, but it didn't accept the files automatically. Drag the {1} images in manually."
  LV: "Maketu darbvieta atvērta, bet tā nepieņēma failus automātiski. Ievelciet attēlus ({1}) manuāli."
  RU: "Рабочая область мокапов открыта, но файлы не были приняты автоматически. Перетащите изображения ({1}) вручную."
• "Place "{1}" in the mockup editor first, then close it to save."
  LV: "Vispirms novietojiet "{1}" maketu redaktorā, tad aizveriet to, lai saglabātu."
  RU: "Сначала разместите «{1}» в редакторе мокапов, затем закройте его, чтобы сохранить."
• "The run has already started — this set can no longer be changed."
  LV: "Palaišana jau ir sākusies — šo komplektu vairs nevar mainīt."
  RU: "Запуск уже начался — этот набор больше нельзя изменить."
• "The model could not be saved. Try again."
  LV: "Modeli neizdevās saglabāt. Mēģiniet vēlreiz."
  RU: "Не удалось сохранить модель. Попробуйте ещё раз."
• "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."
  LV: "Maketu palaišanu neizdevās pabeigt."
  RU: "Запуск мокапов не удалось завершить."
• "the step could not be completed."
  LV: "darbību neizdevās pabeigt."
  RU: "шаг не удалось завершить."
• "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}"
  LV: "Maketi tika saglabāti, bet sludinājumu palaišana neizdevās: {1}"
  RU: "Мокапы сохранены, но запуск листингов не удался: {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."
  LV: "Sazinieties ar ShopPilot administratoru, ja universālā sesija nav pieejama."
  RU: "Свяжитесь с администратором ShopPilot, если универсальная сессия недоступна."
• "Cookie check failed"
  LV: "Sīkfaila pārbaude neizdevās"
  RU: "Не удалось проверить cookie"
• "Could not check the provider session:"
  LV: "Neizdevās pārbaudīt pakalpojuma sniedzēja sesiju:"
  RU: "Не удалось проверить сессию поставщика:"
• "Provider session missing"
  LV: "Nav pakalpojuma sniedzēja sesijas"
  RU: "Сессия поставщика отсутствует"
• "Provider session missing."
  LV: "Nav pakalpojuma sniedzēja sesijas."
  RU: "Сессия поставщика отсутствует."
• "print service returned an error"
  LV: "drukas pakalpojums atgrieza kļūdu"
  RU: "служба печати вернула ошибку"
• "the print service returned a sign-in or error page instead of an image,"
  LV: "drukas serviss attēla vietā atgrieza pieteikšanās vai kļūdas lapu,"
  RU: "сервис печати вернул страницу входа или ошибки вместо изображения,"
• "which almost always means its session expired. Try the folder again, and contact the ShopPilot administrator if it keeps failing."
  LV: "kas gandrīz vienmēr nozīmē, ka tā sesija ir beigusies. Mēģiniet mapi vēlreiz un sazinieties ar ShopPilot administratoru, ja kļūda atkārtojas."
  RU: "что почти всегда означает, что его сессия истекла. Попробуйте папку ещё раз и свяжитесь с администратором ShopPilot, если ошибка повторяется."

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"
  LV: "Fona modelis vēl ielādējas — pēc brīža mēģiniet vēlreiz"
  RU: "Модель для фона ещё загружается — попробуйте чуть позже"
• "bg-swap warnings:"
  LV: "fona maiņas brīdinājumi:"
  RU: "предупреждения замены фона:"
• "● could not reach model"
  LV: "● neizdevās sazināties ar modeli"
  RU: "● не удалось связаться с моделью"
• "● model error:"
  LV: "● modeļa kļūda:"
  RU: "● ошибка модели:"
• "The background style could not be saved. Please try again."
  LV: "Neizdevās saglabāt fona stilu. Lūdzu, mēģiniet vēlreiz."
  RU: "Не удалось сохранить стиль фона. Попробуйте ещё раз."
• "Invalid background colour. Use #e9dde7 format."
• "no eligible mockups found in zip (check zip format)"
  LV: "zip failā nav atrasts neviens piemērots makets (pārbaudiet zip formātu)"
  RU: "в zip-архиве не найдено подходящих мокапов (проверьте формат zip)"

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."
  LV: "Jūsu bezmaksas izmēģinājuma limits ir sasniegts."
  RU: "Лимит бесплатного пробного периода исчерпан."

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"
  LV: "Pieejamības pārbaude neizdevās"
  RU: "Проверка доступности не удалась"
• "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."
  LV: "Neizdevās ielādēt maketu iestatījumus. Lūdzu, mēģiniet vēlreiz."
  RU: "Не удалось загрузить настройки мокапов. Попробуйте снова."
• "That mockup is no longer in your library."
  LV: "Šī maketa vairs nav jūsu bibliotēkā."
  RU: "Этого мокапа больше нет в вашей библиотеке."

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."
  LV: "Neizdevās ielādēt maketu redaktoru. Lūdzu, mēģiniet vēlreiz."
  RU: "Не удалось загрузить редактор мокапов. Попробуйте ещё раз."
• "Failed to load:"
  LV: "Neizdevās ielādēt:"
  RU: "Не удалось загрузить:"
• "The image editor needs a larger screen — open it on a laptop or desktop."
  LV: "Attēlu redaktoram vajag lielāku ekrānu — atveriet to klēpjdatorā vai galddatorā."
  RU: "Редактору изображений нужен экран побольше — откройте его на ноутбуке или компьютере."
• "Mockup editor asset missing"
• "decode failed:"
  LV: "neizdevās nolasīt:"
  RU: "не удалось прочитать:"
• "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:"
  LV: "Maketu palaišana no redaktora neizdevās:"
  RU: "Ошибка запуска мокапов из редактора:"
• "Editor run failed:"
  LV: "Palaišana no redaktora neizdevās:"
  RU: "Ошибка запуска из редактора:"
• "Listing runner missing - try saving and running manually"
  LV: "Trūkst sludinājumu palaidēja — mēģiniet saglabāt un palaist manuāli"
  RU: "Отсутствует модуль запуска листингов — попробуйте сохранить и запустить вручную"
• "Mockup generator missing - try saving and running manually"
  LV: "Trūkst maketu ģeneratora — mēģiniet saglabāt un palaist manuāli"
  RU: "Отсутствует генератор мокапов — попробуйте сохранить и запустить вручную"
• "Nothing to run"
  LV: "Nav ko palaist"
  RU: "Нечего запускать"
• "Run handler missing — try saving and running manually"
  LV: "Trūkst palaišanas apstrādātāja — mēģiniet saglabāt un palaist manuāli"
  RU: "Отсутствует обработчик запуска — попробуйте сохранить и запустить вручную"
• "runMode failed:"
  LV: "runMode neizdevās:"
  RU: "Ошибка runMode:"
• "Editor mockups-only run failed:"
  LV: "Tikai maketu palaišana no redaktora neizdevās:"
  RU: "Ошибка запуска только мокапов из редактора:"
• "Mockup creation failed:"
  LV: "Maketu izveide neizdevās:"
  RU: "Не удалось создать мокапы:"
• "Nothing to save"
  LV: "Nav ko saglabāt"
  RU: "Нечего сохранять"
• "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"
  LV: "Šajā slānī nav ko transformēt"
  RU: "На этом слое нечего трансформировать"
• "Draw a crop first"
  LV: "Vispirms iezīmējiet apgriešanas laukumu"
  RU: "Сначала выделите область обрезки"
• "Clipboard empty"
  LV: "Starpliktuve ir tukša"
  RU: "Буфер обмена пуст"
• "Could not save this preset in the browser"
  LV: "Neizdevās saglabāt šo sagatavi pārlūkā"
  RU: "Не удалось сохранить этот пресет в браузере"
• "Download failed — try again"
  LV: "Lejupielāde neizdevās — mēģiniet vēlreiz"
  RU: "Не удалось скачать — попробуйте ещё раз"
• "Enter a print size from 0.1 to 1000 cm per side"
  LV: "Ievadiet drukas izmēru no 0.1 līdz 1000 cm katrai malai"
  RU: "Введите размер печати от 0.1 до 1000 см на сторону"
• "Enter a name for this canvas size"
  LV: "Ievadiet nosaukumu šim audekla izmēram"
  RU: "Введите название для этого размера холста"

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"
  LV: "Vispirms atlasiet slāni"
  RU: "Сначала выберите слой"
• "Nothing to upscale on this layer"
  LV: "Šajā slānī nav ko palielināt"
  RU: "На этом слое нечего увеличивать"
• "Upscale failed"
  LV: "Palielināšana neizdevās"
  RU: "Не удалось увеличить"
• "The upscaled image could not be loaded."
  LV: "Palielināto attēlu nevarēja ielādēt."
  RU: "Не удалось загрузить увеличенное изображение."
• "Could not prepare image for upscaling."
  LV: "Nevarēja sagatavot attēlu palielināšanai."
  RU: "Не удалось подготовить изображение к увеличению."
• "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"
  LV: "Brīdinājums: veikaliem {1} nebija izvēlēti savi attēli, tāpēc to mapēm tika izmantoti noklusējuma attēli"
  RU: "Предупреждение: у магазинов {1} не были выбраны свои изображения, поэтому для их папок использованы изображения по умолчанию"

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."
  LV: "Dzēst maketu “{1}”?{2} Kopā ar to tiks dzēsta apdare un jūsu dotais nosaukums. Jau izveidotie sludinājumi saglabās savus attēlus."
  RU: "Удалить мокап «{1}»?{2} Вместе с ним удалятся отделка и название, которое вы ему дали. Уже созданные листинги сохранят свои изображения."
• "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."
  LV: "Izmēru tabula, kopšanas kartīte vai piegādes piezīme nav makets. Tā tiek pievienota katram sludinājumam tieši tāda, kāda ir, bez dizaina un bez atzīmēšanas."
  RU: "Таблица размеров, карточка по уходу или заметка о доставке — это не мокап. Она добавляется в каждый листинг как есть, без дизайна и без разметки."
• "Also send the orders already waiting?"
  LV: "Nosūtīt arī jau gaidošos pasūtījumus?"
  RU: "Отправить и уже ожидающие заказы?"
• "Don't show this again"
  LV: "Vairs nerādīt"
  RU: "Больше не показывать"
• "Nothing here yet.<br><button class="ios-btn ghost small" type="button">Choose mockups</button>"
• "Nothing selected yet. Tap anything lying on the print"
  LV: "Vēl nekas nav atlasīts. Pieskarieties jebkam, kas atrodas uz apdrukas,"
  RU: "Пока ничего не выбрано. Нажмите на любой предмет, лежащий на печати,"
• "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"