ShopPilot Bridge (desktop app)

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

ID: bridge-not-found

Seen as:

• "No ShopPilot Bridge answered on this computer."
  LV: "Šajā datorā neatbildēja neviens ShopPilot Bridge."
  RU: "На этом компьютере ShopPilot Bridge не ответил."
• "No ShopPilot Bridge answered on this computer. Open the ShopPilot Bridge app here. Not installed yet? Download it on the Connect Etsy page (Windows or Mac), install it, open it, then try again. If the browser is holding it back, click the site-controls icon beside the address, open Site settings, set Local network access to Allow, then reload ShopPilot. The Mac Bridge needs an Apple chip (M1 or newer) and macOS 13 or newer. The first time, macOS stops it: open System Settings, then Privacy & Security, scroll down and press Open Anyway."
  LV: "Šajā datorā neatbildēja neviens ShopPilot Bridge. Atveriet ShopPilot Bridge lietotni šeit. Vēl nav instalēta? Lejupielādējiet to lapā “Pievienot Etsy” (Windows vai Mac), instalējiet, atveriet un mēģiniet vēlreiz. Ja to aiztur pārlūks, noklikšķiniet uz vietnes iestatījumu ikonas blakus adresei, atveriet Site settings, iestatiet Local network access uz Allow un pārlādējiet ShopPilot. Mac Bridge vajag Mac datoru ar Apple čipu (M1 vai jaunāku) un macOS 13 vai jaunāku. Pirmajā reizē macOS to aptur: atveriet System Settings, tad Privacy & Security, ritiniet uz leju un nospiediet Open Anyway."
  RU: "На этом компьютере не ответил ни один ShopPilot Bridge. Откройте здесь приложение ShopPilot Bridge. Ещё не установлено? Скачайте его на странице «Подключить Etsy» (Windows или Mac), установите, откройте и попробуйте снова. Если его блокирует браузер, нажмите значок настроек сайта рядом с адресом, откройте «Настройки сайта», для «Доступ к локальной сети» выберите «Разрешить» и перезагрузите ShopPilot. Для Mac Bridge нужен Mac с чипом Apple (M1 или новее) и macOS 13 или новее. В первый раз macOS его остановит: откройте «Системные настройки» (System Settings), затем «Конфиденциальность и безопасность» (Privacy & Security), прокрутите вниз и нажмите «Всё равно открыть» (Open Anyway)."
• "No ShopPilot Bridge answered on this computer. Open the ShopPilot Bridge app here. Not installed yet? Download it on the Connect Etsy page (Windows or Mac), install it, open it, then try again. The Mac Bridge needs an Apple chip (M1 or newer) and macOS 13 or newer. The first time, macOS stops it: open System Settings, then Privacy & Security, scroll down and press Open Anyway."
  LV: "Šajā datorā neatbildēja neviens ShopPilot Bridge. Atveriet ShopPilot Bridge lietotni šeit. Vēl nav instalēta? Lejupielādējiet to lapā “Pievienot Etsy” (Windows vai Mac), instalējiet, atveriet un mēģiniet vēlreiz. Mac Bridge vajag Mac datoru ar Apple čipu (M1 vai jaunāku) un macOS 13 vai jaunāku. Pirmajā reizē macOS to aptur: atveriet System Settings, tad Privacy & Security, ritiniet uz leju un nospiediet Open Anyway."
  RU: "На этом компьютере не ответил ни один ShopPilot Bridge. Откройте здесь приложение ShopPilot Bridge. Ещё не установлено? Скачайте его на странице «Подключить Etsy» (Windows или Mac), установите, откройте и попробуйте снова. Для Mac Bridge нужен Mac с чипом Apple (M1 или новее) и macOS 13 или новее. В первый раз macOS его остановит: откройте «Системные настройки» (System Settings), затем «Конфиденциальность и безопасность» (Privacy & Security), прокрутите вниз и нажмите «Всё равно открыть» (Open Anyway)."
• "No ShopPilot Bridge answered on this computer. Open the ShopPilot Bridge app here. Not installed yet? Download it on the Connect Etsy page (Windows or Mac), install it, open it, then try again. {1}"
  LV: "Šajā datorā neatbildēja neviens ShopPilot Bridge. Atveriet ShopPilot Bridge lietotni šeit. Vēl nav instalēta? Lejupielādējiet to lapā “Pievienot Etsy” (Windows vai Mac), instalējiet, atveriet un mēģiniet vēlreiz. {1}"
  RU: "На этом компьютере не ответил ни один ShopPilot Bridge. Откройте здесь приложение ShopPilot Bridge. Ещё не установлено? Скачайте его на странице «Подключить Etsy» (Windows или Mac), установите, откройте и попробуйте снова. {1}"
• "No ShopPilot Bridge answered on this computer. Open the ShopPilot Bridge app here. Not installed yet? Download it on the Connect Etsy page (Windows or Mac), install it, open it, then try again."
  LV: "Šajā datorā neatbildēja neviens ShopPilot Bridge. Atveriet ShopPilot Bridge lietotni šeit. Vēl nav instalēta? Lejupielādējiet to lapā “Pievienot Etsy” (Windows vai Mac), instalējiet, atveriet un mēģiniet vēlreiz."
  RU: "На этом компьютере не ответил ни один ShopPilot Bridge. Откройте здесь приложение ShopPilot Bridge. Ещё не установлено? Скачайте его на странице «Подключить Etsy» (Windows или Mac), установите, откройте и попробуйте снова."
• "The ShopPilot Bridge is not open on this PC."
  LV: "ShopPilot Bridge šajā datorā nav atvērts."
  RU: "ShopPilot Bridge не открыт на этом ПК."
• "Bridge not found. Open the ShopPilot Bridge on this computer and try again."
  LV: "Bridge nav atrasts. Atveriet ShopPilot Bridge šajā datorā un mēģiniet vēlreiz."
  RU: "Bridge не найден. Откройте ShopPilot Bridge на этом компьютере и попробуйте ещё раз."
• "Bridge not found — open the desktop app"
  LV: "Bridge nav atrasts — atveriet darbvirsmas lietotni"
  RU: "Bridge не найден — откройте приложение на компьютере"
• "Bridge not found"
• "Bridge unavailable. Install the Shop Pilot Bridge from the OAuth tab first."
  LV: "Bridge nav pieejams. Vispirms instalējiet ShopPilot Bridge cilnē OAuth."
  RU: "Bridge недоступен. Сначала установите ShopPilot Bridge на вкладке OAuth."
• "Bridge is not available"
  LV: "Bridge nav pieejams"
  RU: "Bridge недоступен"
• "Run and pair ShopPilotBridge.exe first."
  LV: "Vispirms palaidiet un savienojiet ShopPilotBridge.exe."
  RU: "Сначала запустите и подключите ShopPilotBridge.exe."
• "Desktop Bridge not connected"
  LV: "Datora Bridge nav savienots"
  RU: "Bridge на компьютере не подключён"
• "Desktop Bridge required"
  LV: "Nepieciešams datora Bridge"
  RU: "Нужен Bridge на компьютере"
• "The Bridge is still not connected. Open ShopPilot Bridge on this computer"
  LV: "Bridge joprojām nav savienots. Atveriet ShopPilot Bridge šajā datorā"
  RU: "Bridge всё ещё не подключён. Откройте ShopPilot Bridge на этом компьютере"
• "Bridge connected. Try again."
  LV: "Bridge savienots. Mēģiniet vēlreiz."
  RU: "Bridge подключён. Попробуйте снова."
• "Open your ShopPilot Bridge first, then choose the folder."
  LV: "Vispirms atveriet ShopPilot Bridge, tad izvēlieties mapi."
  RU: "Сначала откройте ShopPilot Bridge, затем выберите папку."
• "The Bridge took too long to answer. Reopen it and try again."
  LV: "Bridge atbildēja pārāk ilgi. Atveriet to no jauna un mēģiniet vēlreiz."
  RU: "Bridge слишком долго не отвечал. Откройте его заново и попробуйте ещё раз."
• "ShopPilot could not start the Bridge check. Reload the page and try again."
  LV: "ShopPilot nevarēja sākt Bridge pārbaudi. Pārlādējiet lapu un mēģiniet vēlreiz."
  RU: "ShopPilot не смог начать проверку Bridge. Перезагрузите страницу и попробуйте ещё раз."
• "The browser lost its connection to the Bridge."
  LV: "Pārlūks zaudēja savienojumu ar Bridge."
  RU: "Браузер потерял связь с Bridge."
• "The download could not start. Check that ShopPilot Bridge is open."
• "Bridge connection could not start. Try again in a moment."
• "Bridge connection request is invalid or expired. Try again."
• "This browser is offline."
  LV: "Šis pārlūks ir bezsaistē."
  RU: "Браузер не в сети."
• "Browser offline — reconnect to the internet"
  LV: "Pārlūks ir bezsaistē — atjaunojiet interneta savienojumu"
  RU: "Браузер не в сети — подключитесь к интернету"

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

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

Fix:

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

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

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

Safari can't reach the Bridge

ID: bridge-safari

Seen as:

• "Safari cannot reach the ShopPilot Bridge, even when the Bridge is open: Safari blocks websites from talking to apps on this computer. Open ShopPilot in Google Chrome to use the Bridge. If Chrome asks to "Access other apps and services on this device", press Allow."
  LV: "Safari nevar sasniegt ShopPilot Bridge, pat ja Bridge ir atvērts: Safari neļauj vietnēm sazināties ar lietotnēm šajā datorā. Lai izmantotu Bridge, atveriet ShopPilot pārlūkā Google Chrome. Ja Chrome jautā, vai atļaut piekļuvi citām lietotnēm un pakalpojumiem šajā ierīcē ("Access other apps and services on this device"), nospiediet Atļaut (Allow)."
  RU: "Safari не может связаться с ShopPilot Bridge, даже когда Bridge открыт: Safari не позволяет сайтам обращаться к приложениям на этом компьютере. Чтобы пользоваться Bridge, откройте ShopPilot в Google Chrome. Если Chrome спросит разрешение на доступ к другим приложениям и сервисам на этом устройстве («Access other apps and services on this device»), нажмите «Разрешить» (Allow)."

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

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

Fix:

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

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

The browser blocked the Bridge (Local network access)

ID: bridge-browser-blocked

Seen as:

• "The browser blocked the Bridge. Allow Local network access in this site's settings, then reload ShopPilot."
  LV: "Pārlūks bloķēja Bridge. Šīs vietnes iestatījumos atļaujiet Local network access un pārlādējiet ShopPilot."
  RU: "Браузер заблокировал Bridge. Разрешите «Доступ к локальной сети» в настройках сайта и перезагрузите ShopPilot."
• "Browser blocked the Bridge — allow Local network access in Site settings"
  LV: "Pārlūks bloķēja Bridge — atļaujiet piekļuvi lokālajam tīklam vietnes iestatījumos"
  RU: "Браузер заблокировал Bridge — разрешите доступ к локальной сети в настройках сайта"
• "The browser has blocked the Bridge for this site."
  LV: "Pārlūks šai vietnei ir bloķējis Bridge."
  RU: "Браузер заблокировал Bridge для этого сайта."
• "Desktop access is blocked in this site's permissions."
  LV: "Šīs vietnes atļaujās ir bloķēta piekļuve datoram."
  RU: "Доступ к компьютеру заблокирован в разрешениях этого сайта."
• "ShopPilot is blocked from opening the Bridge. Click the site-controls icon beside the address, open Site settings, set Local network access to Allow, reload, and try again."
  LV: "ShopPilot nevar atvērt Bridge, jo tas ir bloķēts. Noklikšķiniet uz vietnes iestatījumu ikonas blakus adresei, atveriet Site settings, iestatiet Local network access uz Allow, pārlādējiet lapu un mēģiniet vēlreiz."
  RU: "ShopPilot заблокирован и не может открыть Bridge. Нажмите значок настроек сайта рядом с адресом, откройте «Site settings», установите «Local network access» на «Allow», перезагрузите страницу и попробуйте снова."

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

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

Fix:

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

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

The Bridge is open but not paired, or pairing fails

ID: bridge-not-paired

Seen as:

• "The Bridge is open but not paired. Paste your ShopPilot access key into the Bridge."
  LV: "Bridge ir atvērts, bet nav savienots pārī. Ielīmējiet Bridge savu ShopPilot piekļuves atslēgu."
  RU: "Bridge открыт, но не привязан. Вставьте в Bridge ваш ключ доступа ShopPilot."
• "Desktop Bridge is not paired"
  LV: "Datora Bridge nav sapārots"
  RU: "Bridge на компьютере не привязан"
• "Bridge isn’t paired yet. Open the bridge and enter your SP-XXXX key."
  LV: "Bridge vēl nav savienots. Atveriet Bridge un ievadiet savu SP-XXXX atslēgu."
  RU: "Bridge ещё не подключён. Откройте Bridge и введите ключ SP-XXXX."
• "Bridge is running, but it is not paired yet."
  LV: "Bridge darbojas, bet vēl nav sapārots."
  RU: "Bridge запущен, но ещё не сопряжён."
• "Bridge not paired"
• "Bridge is not paired."
  LV: "Bridge nav savienots pārī."
  RU: "Bridge не сопряжён."
• "Bridge token missing or invalid."
• "Bridge token missing or invalid"
  LV: "Bridge marķieris trūkst vai nav derīgs"
  RU: "Токен Bridge отсутствует или недействителен"
• "Enter your ShopPilot access key first."
• "Enter your ShopPilot key first."
• "Pairing failed ({…})."
• "Register failed ({…})."
• "Bridge auth required."
• "A validated access key is required."
• "Bridge attestation is required. Refresh Shop Pilot and use the latest Bridge."
• "The paired Bridge could not be verified. Reopen or update it."
• "Too many attempts. Try again in a minute."
• "Too many bridge pairs for this key recently. Try again later."
• "This Bridge is too old to pair securely. Download the latest ShopPilot Bridge and try again."
• "This key already has {…} authorized Bridge computer{…}. Ask the administrator to revoke or reset one."

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

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

Fix:

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

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

Free trial: this computer can't use the Bridge

ID: bridge-trial-computer

Seen as:

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

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

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

Fix:

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

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

ID: bridge-mac-open

Seen as:

• "The Mac Bridge needs an Apple chip (M1 or newer) and macOS 13 or newer. The first time, macOS stops it: open System Settings, then Privacy & Security, scroll down and press Open Anyway."
  LV: "Mac Bridge vajag Mac datoru ar Apple čipu (M1 vai jaunāku) un macOS 13 vai jaunāku. Pirmajā reizē macOS to aptur: atveriet System Settings, tad Privacy & Security, ritiniet uz leju un nospiediet Open Anyway."
  RU: "Для Mac Bridge нужен Mac с чипом Apple (M1 или новее) и macOS 13 или новее. В первый раз macOS его остановит: откройте «Системные настройки» (System Settings), затем «Конфиденциальность и безопасность» (Privacy & Security), прокрутите вниз и нажмите «Всё равно открыть» (Open Anyway)."
• "The Mac Bridge needs an Apple chip (M1 or newer) and macOS 13 or newer."
  LV: "Mac Bridge vajag Mac datoru ar Apple čipu (M1 vai jaunāku) un macOS 13 vai jaunāku."
  RU: "Для Mac Bridge нужен Mac с чипом Apple (M1 или новее) и macOS 13 или новее."
• "This first build is not notarised yet, so the very first launch needs a right-click then Open instead of a double-click. If your Mac still will not open it, go to System Settings, then Privacy & Security, scroll down and click Open Anyway. Download it from the Connect Etsy page, under Desktop Bridge."
  LV: "Šī pirmā versija vēl nav notarizēta, tāpēc pašā pirmajā palaišanas reizē dubultklikšķa vietā noklikšķiniet ar labo peles pogu un izvēlieties Open. Ja Mac to joprojām neatver, atveriet System Settings, tad Privacy & Security, ritiniet uz leju un noklikšķiniet Open Anyway. Lejupielādējiet to sadaļā “Pievienot Etsy”, zem Desktop Bridge."
  RU: "Эта первая сборка ещё не нотаризована, поэтому при самом первом запуске вместо двойного щелчка нажмите правой кнопкой и выберите «Открыть». Если Mac всё равно не открывает её, перейдите в «Системные настройки» → «Конфиденциальность и безопасность», прокрутите вниз и нажмите «Всё равно открыть». Скачать можно в разделе «Подключить Etsy», в блоке Desktop Bridge."

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

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

Fix:

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

Mac or Windows: the Bridge update failed

ID: bridge-update-failed

Seen as:

• "Update your ShopPilot Bridge from the Guide tab, then try again."
  LV: "Atjauniniet ShopPilot Bridge cilnē Ceļvedis un mēģiniet vēlreiz."
  RU: "Обновите ShopPilot Bridge во вкладке «Руководство» и попробуйте ещё раз."
• "Desktop Bridge update required"
  LV: "Jāatjaunina datora Bridge"
  RU: "Нужно обновить Bridge на компьютере"
• "Update and reopen the ShopPilot Bridge from the Connect Etsy page, then try again. The older Bridge can leave the folder picker hidden behind Chrome."
  LV: "Atjauniniet un atkārtoti atveriet ShopPilot Bridge sadaļā “Pievienot Etsy”, tad mēģiniet vēlreiz. Vecāks Bridge var atstāt mapes izvēles logu paslēptu aiz Chrome."
  RU: "Обновите и заново откройте ShopPilot Bridge в разделе «Подключить Etsy», затем попробуйте снова. Старый Bridge может оставить окно выбора папки скрытым за Chrome."
• "Bridge unsupported in this build"
  LV: "Šajā versijā Bridge netiek atbalstīts"
  RU: "Bridge не поддерживается в этой версии"
• "Bridge support is unavailable in this build."
  LV: "Šajā versijā Bridge atbalsts nav pieejams."
  RU: "В этой сборке поддержка Bridge недоступна."
• "The macOS update needs administrator approval."
• "The Bridge filename must be ShopPilotBridge.exe or a numbered browser download such as ShopPilotBridge (2).exe before updating."
• "Could not locate the running ShopPilotBridge.app bundle."
• "Update check failed ({…})."
• "Update download failed ({…})."
• "Bridge update not found."
• "Bridge build not available."
• "macOS could not stage the replacement app."

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

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

Fix:

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

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

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

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

ID: bridge-windows-start

Seen as:

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

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

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

Fix:

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

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

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

ID: bridge-folders

Seen as:

• "Bridge is connected, but no parent folder is selected."
  LV: "Bridge ir savienots, bet nav izvēlēta galvenā mape."
  RU: "Bridge подключён, но родительская папка не выбрана."
• "Bridge is not paired or no parent folder is selected."
• "Bridge is not paired or no parent folders are selected."
• "No folders selected."
• "(no folder selected)"
  LV: "(mape nav izvēlēta)"
  RU: "(папка не выбрана)"
• "The selected folder could not be opened."
• "The selected folder could not be saved by the Bridge."
• "The selected folder is no longer available."
• "This Bridge build cannot open the folder picker."
• "That folder is already selected."
• "That folder path could not be saved."
• "ShopPilot Bridge could not save its settings. Please try again."
• "ShopPilot Bridge could not save its settings. {…} Check that the folder is not read-only, then try again."
• "The file could not be written."
• "The folder window could not be created."
• "The folder window failed."
• "The folder window refused several folders."
• "Folder selection timed out."
• "The selected folders are no longer available."
• "The Bridge could not read {1}. Keep the Bridge open, or choose the folders again."
  LV: "Bridge nevarēja nolasīt {1}. Turiet Bridge atvērtu vai izvēlieties mapes vēlreiz."
  RU: "Bridge не смог прочитать {1}. Не закрывайте Bridge или выберите папки снова."
• "That file is no longer in its folder. Choose the folders again."
• "Folder was not found."
• "The Bridge did not return your folder list. Try again, or reopen the Bridge."
  LV: "Bridge neatgrieza jūsu mapju sarakstu. Mēģiniet vēlreiz vai atveriet Bridge no jauna."
  RU: "Bridge не вернул список ваших папок. Попробуйте ещё раз или откройте Bridge заново."
• "A folder named {1} is in more than one folder added to the ShopPilot Bridge, and this Bridge cannot pick the one in {2}. Update the ShopPilot Bridge."
  LV: "Mape ar nosaukumu {1} ir vairākās mapēs, kas pievienotas ShopPilot Bridge, un šis Bridge nevar izvēlēties to, kas ir {2}. Atjauniniet ShopPilot Bridge."
  RU: "Папка с именем {1} есть в нескольких папках, добавленных в ShopPilot Bridge, и этот Bridge не может выбрать ту, что в {2}. Обновите ShopPilot Bridge."
• "Duplicate folder name across parent folders. Rename one copy before using this listing."
• "No supported images found."
• "That file is too large."

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

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

Fix:

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

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

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

ID: bridge-save-upload

Seen as:

• "Bridge offline - {1} saved on the server only. Start the desktop bridge to keep a local copy on your PC."
  LV: "Bridge nav pieslēgts — {1} saglabāts tikai serverī. Palaidiet datora lietotni Bridge, lai saglabātu kopiju savā datorā."
  RU: "Bridge не подключён — {1} сохранено только на сервере. Запустите приложение Bridge на компьютере, чтобы сохранить копию на ПК."
• "Bridge offline — {1} saved on the server only."
  LV: "Bridge nav pieslēgts — {1} saglabāts tikai serverī."
  RU: "Bridge не подключён — {1} сохранено только на сервере."
• "Bridge save failed: {1}"
  LV: "Bridge saglabāšana neizdevās: {1}"
  RU: "Не удалось сохранить через Bridge: {1}"
• "Could not save {1}. Update the bridge and try again."
  LV: "Neizdevās saglabāt {1}. Atjauniniet Bridge un mēģiniet vēlreiz."
  RU: "Не удалось сохранить {1}. Обновите Bridge и попробуйте снова."
• "Open the Bridge and try again, or turn on Save to server to keep them on the server."
  LV: "Atveriet Bridge un mēģiniet vēlreiz vai ieslēdziet “Saglabāt serverī”, lai tās paliktu serverī."
  RU: "Откройте Bridge и попробуйте снова или включите «Сохранять на сервере», чтобы оставить их на сервере."
• "The ShopPilot Bridge is closed, so the folders cannot be saved to your PC."
  LV: "ShopPilot Bridge ir aizvērts, tāpēc mapes nevar saglabāt datorā."
  RU: "ShopPilot Bridge закрыт, поэтому папки нельзя сохранить на ПК."
• "Stopped before generating: the ShopPilot Bridge is closed and Save to server is off."
  LV: "Apturēts pirms ģenerēšanas: ShopPilot Bridge ir aizvērts un "Saglabāt serverī" ir izslēgts."
  RU: "Остановлено до генерации: ShopPilot Bridge закрыт, а «Сохранять на сервер» выключено."
• "The Bridge could not upload the folders from your PC. Open the Bridge and try again. Nothing was planned."
  LV: "Bridge nevarēja augšupielādēt mapes no jūsu datora. Atveriet Bridge un mēģiniet vēlreiz. Nekas netika ieplānots."
  RU: "Bridge не удалось загрузить папки с вашего ПК. Откройте Bridge и попробуйте снова. Ничего не запланировано."
• "Local bridge upload failed"
  LV: "Augšupielāde caur Bridge neizdevās"
  RU: "Не удалось загрузить через Bridge"
• "Local bridge upload failed."
  LV: "Augšupielāde caur Bridge neizdevās."
  RU: "Не удалось загрузить через Bridge."
• "Local bridge upload failed:"
  LV: "Augšupielāde caur Bridge neizdevās:"
  RU: "Не удалось загрузить через Bridge:"
• "The ShopPilot Bridge could not send {1} from {2}."
  LV: "ShopPilot Bridge nevarēja nosūtīt {1} no {2}."
  RU: "ShopPilot Bridge не смог отправить {1} из {2}."
• "The ShopPilot Bridge could not send {1} from {2}: {3}."
  LV: "ShopPilot Bridge nevarēja nosūtīt {1} no {2}: {3}."
  RU: "ShopPilot Bridge не смог отправить {1} из {2}: {3}."
• "Folder is too large for the bridge."
• "Empty upload."
• "Folder upload must be a zip archive."
• "A supplied folder name is invalid."
• "Folder names cannot contain path separators."
• "Missing folder name."
• "Combined extracted folders exceed the bridge safety limit."
• "Folder archive could not be installed safely: {…}.{…}"
• "The bridge could not create a safe extraction stage."
• "Zip contains duplicate file paths."
• "Zip contains too many files."
• "Zip expands beyond the bridge safety limit."
• "Zip file conflicts with an existing directory."
• "Combined folder downloads exceed the bridge safety limit."
• "Download failed: {…}"
• "Upload failed ({…})."
• "batch {…} failed after {…} attempt(s): {…}"
• "Request body is too large."

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

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

Fix:

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

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

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

The Bridge download button says "not available yet"

ID: bridge-download-unavailable

Seen as:

• "{1} Bridge is not available yet"
  LV: "{1} Bridge vēl nav pieejams"
  RU: "Bridge для {1} пока недоступен"
• "{1} Bridge is not available yet."
  LV: "{1} Bridge vēl nav pieejams."
  RU: "Bridge для {1} пока недоступен."
• "{1} Bridge not available yet"
  LV: "{1} Bridge vēl nav pieejams"
  RU: "Bridge для {1} пока недоступен"
• "Download status unavailable."
  LV: "Lejupielādes statuss nav pieejams."
  RU: "Статус загрузки недоступен."

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

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

Fix:

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

Rare technical messages (Bridge)

ID: bridge-rare

Seen as:

• "Some Bridge cache files could not be removed."
• "A local listener answered but could not prove it is the ShopPilot Bridge."
  LV: "Lokālais klausītājs atbildēja, bet nevarēja pierādīt, ka tas ir ShopPilot Bridge."
  RU: "Локальный обработчик ответил, но не смог подтвердить, что это ShopPilot Bridge."
• "Something is answering on the Bridge's port but cannot prove it is the ShopPilot Bridge. Download and reopen the newest Bridge; if it keeps happening, another program has taken the port."
• "Could not reach Shop Pilot: {…}: {…}"

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

Fix:

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

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

Not errors: labels and notes (Bridge)

ID: bridge-not-errors

Seen as:

• "Already connected in the Bridge"
  LV: "Jau pievienota Bridge"
  RU: "Уже подключена в Bridge"
• "Keep the Bridge running whenever ShopPilot needs to read or save files on your computer."
  LV: "Turiet Bridge ieslēgtu vienmēr, kad ShopPilot jālasa vai jāsaglabā faili jūsu datorā."
  RU: "Держите Bridge запущенным, когда ShopPilot нужно читать или сохранять файлы на вашем компьютере."
• "Not connected yet — open the link below."
  LV: "Vēl nav pievienots — atveriet zemāk esošo saiti."
  RU: "Ещё не подключено — откройте ссылку ниже."