Market Research

Measure design themes and whole categories against Etsy's public evidence.

Try
Search options
Sample How many live listings to measure. Bigger is slower and steadier.
Evidence How much shop history to pull in behind each listing.
Buyer market
What these numbers mean Every score below is built from Etsy facts, not estimates
Opportunity
Demand, low supply and accessibility combined into one 0–100 figure. Use it to rank themes against each other, not as a forecast.
Demand
Favorites and views measured against how long each listing has been up, so a five-year-old listing does not out-rank a strong new one.
Low supply
How many live Etsy listings already sell this theme. Fewer means less to out-rank on day one.
Accessibility
How much of the current supply comes from young or small shops. High means established sellers are not holding every top slot.
Shop sales / month
A shop's lifetime sales divided by its age. A long-run average, not what it sold last month — Etsy does not publish that.
Fresh share
The proportion of the supply listed recently. A high share says other sellers are still entering the theme.

Etsy's API publishes no search volume and no per-listing units sold, so search volume never appears here, and Units sold is only counted for shops ShopPilot is watching, from the stock that leaves each listing. Anything labelled "per month" is a lifetime total divided by age.

Saved themes

0 saved
Save a promising theme to build its first baseline. ShopPilot will check it every day.

Listing Scheduler

Pick folders, set the days and times, and the server creates the listings on schedule, even with your computer off. Plan listings on a calendar. The server posts them on time, even with your computer off.

Calendar
PlannedPostedFailed or skipped
Today
Loading the calendar...
Plans
No plans yet.
Weekly plan the same days and times every week, without the calendar
Plan shop
No shop profile yet
Idle
No slot is running
No ETA
Folders
Schedule
Actions
Recent runs
Nothing has run yet.

Run

Select product folders, preview the generated copy, then create Etsy drafts.

Idle
No batch is running
No ETA
Folders
0 selected
Green = ready. Orange = needs files. Blue = already drafted.
Options
Stop on first failure
Auto-archive uploaded folders
Notify me when a run finishes
Optional batch safety and cleanup controls.
Actions
Advanced tools
Override folder path
Use only when the folder is outside your normal listings folder.

Listing Progress

Step-by-step listing progress and the Etsy listing preview.

Bulk Edit Listings

Your live Etsy shop, edited in bulk. Draft review uses the local Registry and does not fetch from Etsy.

Nothing synced yet
Bulk Edit 0 listings selected

Every edit is written straight to Etsy and cannot be undone from here. Preview first.

Registry

Local history of generated listings, previews, drafts, and failed runs.

Listings
Status: draft needs review · published live · partial needs attention.

Format: .
Not configured

Display name

OAuth Setup

Connect Etsy for the currently active shop profile. Generate the link, then open it in a browser that is already signed in to the Etsy shop you intend to connect.

Desktop Bridge — folders & local tools
Status Not detected
Download Bridge for Windows Download Bridge for Mac
Active Profile
Profile —
—
Current Token —
OAuth Callback Checking…
To switch profiles, open the Profiles panel.
Generate Token
Log
Idle.

Analytics

Optional Etsy analytics sync for the active shop. Nothing is fetched until you click Load from Etsy.

Recent trend
—
Load analytics to show the trend.
Orders
—
Revenue
—
Total Listing Views
—
All active listings
Favourites
—
All active listings

Folders

Your folder for each shop
Choose the folder on this computer that holds each shop's listing folders. Your Bridge saves that shop's mockups there and finds its folders there. This changes only your computer, not the shop owner's.

Niches

Add a niche
Enter the product type only. After adding it, ShopPilot asks for this shop's exact listings folder and the master listing its runs build from. Phone Cases also keeps its dedicated mockup and order tools.
Your niches1 niche

Master Listings

Loading selected shop…

Settings

Checking storage…

Referrals

Invite customers directly, track verified Shop Pilot benefits, reduce your bill, or unlock more Etsy shop capacity.

Prompt Lab

Adjust how AI writes titles, descriptions, tags, and rules.

Saved
Presets
A preset holds this whole page: title mode and template, tag and hashtag counts, emoji, banned words, required keywords, extra instructions and the custom prompt. Presets belong to your account and stay available in every shop and niche. Choosing one fills the boxes below and saves them to this niche straight away.
Title Generation
AI generates both title variants on every run. The selected mode decides which one is sent to Etsy.
Prompt Controls
These rules affect future copy generation. Etsy does not accept emoji in a title, a tag or a material, so any that reach those are removed before the listing is sent.
Prompt Version
Built-in Prompt
Custom Override
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.

Guide

1 · First-time setup

1

Log in with your email and password

Log in with the email and password of your ShopPilot account. Your access key is entered once, in your account under Activation Key, and it controls how long your access lasts. Your shops, folders, and history never mix with anyone else's.

2

Install the desktop Bridge

The Bridge is a tiny app that runs on your PC. It lets Shop Pilot read your local design folders, save finished folders back to your computer, and run the AI upscaler locally (no cloud cost). Without it you can still work with server-side folders, but the Bridge is what makes everything feel native.

Download it from the OAuth Setup tab → Download Bridge, run the .exe, and leave it running in the tray.

The Bridge only talks to your own Shop Pilot account using a secure device token. It never opens you up to anyone else.
3

Install Upscayl (for AI upscaling)

Upscayl is the free, open-source AI upscaler Shop Pilot uses to sharpen low-resolution designs — it runs on your own PC through the Bridge, so it costs nothing per image. Install it once and Shop Pilot finds it automatically.

Download Upscayl
If the editor says "AI upscaler is not installed", Upscayl isn't on this PC (or the Bridge can't see it). Install it from the link above and restart the Bridge.

2 · Connect Etsy & the mockup provider

1

Connect Etsy (OAuth)

In OAuth Setup, generate and copy the Etsy link. Open it in a browser already signed in to the exact Etsy shop you intend to connect. Etsy returns the browser to ShopPilot's secure callback, and each shop profile keeps its own Etsy token.

2

Connect the mockup provider

Mockups use the administrator-managed universal provider session. It is checked automatically before each run — contact the ShopPilot administrator if mockups stop coming back.

3 · Profiles

1

One profile per shop

In Settings, create one profile for each shop or product line. Connect Etsy through OAuth Setup; Shop Pilot stores the resulting shop identity and token automatically. Use the profile for listing roots, prompt tweaks, and other shop-specific settings.

4 · Designs & folders

1

One folder per product

Each product/design lives in its own listing folder. The Create Listings tab colour-codes them: green = ready, orange = needs files, blue = already drafted.

2

Local vs. server folders

A folder can live on your PC (via the Bridge), on the server, or both. A folder drawn dashed and faded exists only on the server (hover it: "server only — not on your PC") — use Save to PC to pull it. A folder that is only on your PC can be sent up with Upload to server (the same button), without running a listing. (Tip: Shop Pilot recognizes any leading folder ID, such as f84, e464, or art12, even after a shop renames the folder.)

3

Build a set from the image grid

The Curate tab scores and de-duplicates design references, then lays every result into one continuous grid. Related matches stay next to each other, but you can mix any images. Tap images in the order you want; phone-case picks automatically form color-coded sets of five with numbers 1–5 repeated in every set. Then use Create set to download, edit, or run the mockup workflow. Images with a visible @handle or watermark are automatically skipped.

4

The master's filenames decide the gallery, not folder size

Each folder needs a file for every filename the master records; those files fill its slots. A folder may hold more: anything the master does not name stays behind, and pure-number sources such as 1.png through 5.png are ignored. A folder missing one of the named files is refused before the run starts, and the message names the file.

On Create Listings, click a folder to select it; Ctrl-click (⌘ on a Mac) adds more and Shift-click selects a range. On a phone, tap to add or remove.

5 · Master Listings

1

Create a master

A master is what every run builds from: category, photos, variations, price and base copy. It lives in your ShopPilot account, and after it is created nothing about it is ever read from Etsy again. Three ways to make one:

Use phone case built-in master — a ready-made phone-case master: Etsy's phone-case category, a description with the markers in place, 12 photo slots, 70 phone models × 5 designs, and a personalisation question.

Add from Etsy — copies one of your existing listings once, through that shop's saved route.

New blank master — an empty one; pick its category in the editor.

2

Upload its photos — this is the important step

Open Edit on the master and upload your own photo file into each slot. ShopPilot records each filename, and that becomes the rule every run follows: in each listing folder it looks for a file with that name and puts it in that slot.

Because one shop names its files the same way in every folder, one master works for all of them. Nothing depends on sort order, so a stray file can never take the primary slot.

Until you upload your own, a slot uses our mockup generator’s filename, so folders the generator made match as they are. Replace a slot’s photo whenever your folders are named differently.

Matching ignores capitalisation and accepts a different image extension for the same name. A folder file the master does not name simply stays behind. Pure-number files such as 1.png are treated as design sources and never uploaded.
3

Edit everything else in the same place

The editor's tabs cover the rest: Photos for order and which slot shows which variation, Details for title, price, description and tags, Variations for properties and their values — including bulk paste and per-value pricing — Personalization for buyer questions, and Category for the Etsy category and its attributes.

The description must contain {{INTRO}} where the generated opening copy goes and {{HASHTAGS}} where the hashtag block goes, exactly as written. {{SHOP_URL}} is optional and links to the shop's storefront. A run is refused without the first two.
4

Choose it on the niche, and give that niche this shop's Etsy settings

Open Niches, pick the niche, and use Choose under Saved master listing. Niches always edits the shop that is active in the sidebar. One master can serve as many niches and shops as you like.

To change a master for one shop only, press Duplicate on its card and choose the copy on that shop's niche. The copy is made inside Shop Pilot, so nothing is created on Etsy.

A master is portable, so it carries no shop settings of its own. This shop's Etsy settings appears below it — choose Refresh, pick this shop's, and save.

A shipping profile, a return policy and a processing profile are required; a run is refused without them and says which is missing. A production partner is required too whenever the master says the item was made by someone else, because Etsy refuses those listings without one. The shop section is optional.
5

Copy to Etsy is optional

Copy to Etsy creates one draft on Etsy that is a copy of the master, mapped onto the selected shop's own settings. It never publishes, and runs never need it — for those, choosing the master on a niche is the whole setup.

6 · Mockup editor & AI upscale

1

Auto-prep frames your design

When a design goes into a mockup, Shop Pilot fits it to the phone-case canvas automatically: a plain background gets a clean flood of its own colour, vertical stripes are extended so the lines continue, busy art is smart-cropped, and a design that already fills a case-shaped frame is passed through untouched. The phone camera area is kept clear of important art.

2

AI upscale low-res designs

Open a design in the Mockup Editor, pick a layer, and use AI Upscale (Mode + Scale) → Upscale selected layer. It runs locally through the Bridge with Upscayl; the final file exports at the canvas resolution shown at the top of the editor. Use this on small or blurry source images before generating mockups.

Need Upscayl? Download it here and restart the Bridge.
3

Create mockups, then run

Create mockups only saves every open tab as the artwork that goes on the case and generates the mockups without touching Etsy — there is no separate save step. Tick Create mockups + listings to add the shop, background, mode and Run pipeline: that does the same and then hands the new folder back to Create Listings to preview, draft, or publish in your chosen mode.

7 · Generate copy & run

1

Tune copy in Prompt Lab

In Prompt Lab set the custom prompt, title template, tag count, banned words, required keywords and extra rules. Always Preview one folder before a big batch so you can see real titles, tags and attributes.

2

Preview the copy before uploading

Use Preview Copy until the output is right. Create Draft and Publish always perform real Etsy actions.

Create Draft and Create + Publish Live always create real Etsy listings in the shop you confirmed. Double-check it first.
3

Preview → Draft → Publish

Run a batch and watch it on the Listing Progress tab. Each folder's result appears as a card you can click to review the full mockup gallery and generated copy, with prev/next across the whole run.

8 · Review & track

1

Draft Review before publishing

Open Review Drafts on Create Listings to inspect copy, images and options for every draft, then publish or delete the ones you select — all without opening Etsy in the browser.

2

Registry is your history

Registry lists every listing — draft, published, partial, failed — with the folder, Etsy link and quick actions. Filter by status to find what needs attention.

3

Keep the workspace clean

Turn on Auto-archive to move successfully-uploaded folders into _uploaded automatically, so your active list only shows what's left to do.

9 · Every tab explained

Curate

What it does

Add search themes; Shop Pilot finds, scores, and clusters matching designs into cohesive sets. Each chosen set can become a listing folder later.

Collections and style

Each collection has its own searches, optional references, settings, and learned style. The editable FAVOR and AVOID profile is tailored to that collection and improves as you choose designs.

Searches and cookies

Put one theme on each line. Cookies are optional but strongly recommended because searches return fewer and less varied results without them.

Running

Curate all processes every configured collection in one job and skips collections that have no search queries. Finished sets remain available until you clear them.

Create Mockups

What it does

Prepares print-ready designs, optionally generates phone mockups, and saves each batch into the next product folder.

Batching

Phone cases are grouped in fives, so ten designs make two listing folders. Posters and Smart mockups make one folder per design.

Output and styles

Choose Mockups + designs or Design files only. Mockup style choices belong to the active shop profile, and the first required style is always included.

Create Listings

What it does

Select product folders, preview the generated copy, then create Etsy drafts or publish.

Shop safety gate

A shop profile must be confirmed before a preview, draft, or publish run. Shop Pilot then uses only that profile's settings, Etsy token, shop ID and listing root.

Preview and Etsy actions

Preview Copy makes no Etsy call. Create Draft and Create + Publish Live act on the active shop only.

Auto Orders

What it does

Your Etsy orders go into your Alerio cart, ready to print. You pay in Alerio, and the tracking number goes back to Etsy.

How to use it

Press Check for new orders. Under To send, tick the ready orders and press Add to Alerio cart. When Alerio ships them, press Add tracking to Etsy under Shipped, or turn on the automatic check in Settings.

No double orders

Every item is tracked on its own. An order that may already be in your Alerio cart is locked, so it is never added twice. It says Not confirmed: look in your Alerio cart, and if it is not there, open the order and press Send it again.

Bulk Edit

What it does

Optionally loads listings that already exist in the active Etsy shop. Nothing is fetched until you request a live sync.

Separate from Draft Review

Draft Review reads the local Registry and does not fetch from Etsy. Bulk edit on this page writes straight to your live Etsy listings, including prices and variations, so preview first.

Registry

What it holds

A local history of listing previews and Etsy attempts, newest first, with the folder, result, and available review actions.

Forget

Forget removes only the local Registry record. It does not change or delete anything on Etsy.

Analytics

What it does

Optionally loads Etsy analytics for the active shop. Nothing is fetched until you click Load from Etsy, and the figures cover that shop's active listings.

Listing Progress

What it shows

Step-by-step progress for the current listing run, plus completed folder cards and Etsy listing previews. Start here when a run behaves unexpectedly.

Review

Open a completed result to inspect its full mockup gallery and generated copy, then move between the folders from that run.

Market Research

What it does

Runs keyword, product and niche research over public marketplace data, with filters and evidence to help compare opportunities.

Mockup Editor

What it does

Provides layer-based artwork editing with selections, brushes, crop, transform, and export controls on a canvas that adapts to each image.

Transform and upscale

Use Free Transform to move, scale, and rotate a layer. AI Upscale runs locally through the Bridge and Upscayl, then exports at the active canvas resolution.

Background Changer

What it does

Replaces the background of eligible mockup images and saves JPG copies using the color you choose.

Files and presets

Pure-number design sources are skipped automatically. A preset stores a color under a shop-friendly name and uses that name in the output folder.

Niches

What a niche owns

Each niche owns its listing folder, the master its runs build from, that shop's own Etsy settings, gallery positions, and variation-photo mapping for the active shop.

Where the master comes from

Choose a saved master from your library; runs build only from those. Import one from Etsy, start from the built-in, or create a blank master, then upload its photos.

This shop's Etsy settings

A saved master carries no shipping profile, return policy or processing profile of its own. Choose Refresh to load this shop's from Etsy, pick them, and save, or the run is refused.

Copying settings

Copy from another shop… creates the same shipping, return and processing settings in this shop on Etsy. A shop's folder and Etsy connection are never copied.

Referrals

When benefits begin

Referral benefits begin only after the referred customer's payment passes verification. Validated credit carries forward until it is used.

Modes

Bill reduction applies eligible credit to an invoice. Expansion applies credit toward a higher final shop count, with the resulting plan price taking effect at renewal.

Settings

Shop profiles

Use one profile for each Etsy shop so its identity, listing configuration and folder setup stay separate.

Saved values

Settings on this page belong to the selected profile. Blank profile fields inherit the base default, and Reset clears the profile override so the default applies again.

Organization (in Settings)

What it does

Sort your shops and your mockups into sections, for example Mouse pads or Phone cases. Open Settings and press Organization at the top.

Make a section

Press + New section and give it a name. Then press + Choose shops to pick its shops, and + Choose mockups to pick its mockups: iPhone PS, Poster and Smart mockups each have a tab there. On Create Mockups, the + next to the tabs makes a section for the shop you are working on.

Sharing

A shop can be in several sections, and sections can share mockups. Smart mockups always shows every Smart mockup, so you can edit them all in one place.

Which mockups show

A section's mockups only show when one of its shops is picked. A section with no shops shows its mockups for every shop.

Mockups for each shop

Every shop has its own row, and the shops in no section are under Other shops. In a section with several shops, press Choose mockups on a shop and tick what it uses. What it uses now is ticked. A section with one shop has one Choose mockups, under its mockups. On Create Mockups and in Curate, a shop gets only its own.

New mockups

A mockup or info photo you add is for the shop you are working on, and for the section you are in. Other shops get it when you tick it for them, or press Use here too on it in Smart mockups.

Info photos

A size chart or a care card goes into every listing as it is. Add one with Add info photo on Smart mockups, Poster or iPhone PS. On phone cases it comes after the other photos. Add it to the shop's master listing too, like any other photo.

Where you see it

Your shop lists show the section names as headings. On Create Mockups each section has its own tab; a section with more than one kind of mockup has a switch for them under the tabs. When you create a set in Curate, a section with Smart mockups is in the Product list.

Tabs and sections

On Create Mockups, drag any tab to move it, also in front of iPhone PS. Drag a Smart mockup onto a section's tab, or press Sections on it, to put it in a section.

File names

Every mockup has its own number, shown on its tile, and its pictures always carry it: mockup_8591_chillflags1.jpg comes from mockup 8591. Ticking, unticking, moving or deleting other mockups renames nothing, and a master listing finds each photo by that number, even after you rename the mockup. Masters made from older folders (mockup_01_…) still find their photos by the mockup's name.

Deleting a section

Only the heading is deleted. Its shops stay, and every Smart mockup stays in Smart mockups.

Prompt Lab

What it controls

Controls how listing titles, descriptions, tags, and hashtags are generated for the active niche.

Preview first

Rule and prompt changes affect future copy only. Leave the custom prompt blank to use the built-in prompt, and preview a folder before running a large batch.

OAuth Setup

Connecting a shop

Generate the Etsy authorization link for the active shop profile, then open it in a browser signed in to the exact Etsy shop you intend to connect.

Bridge

Download and keep the Shop Pilot Bridge running whenever the app needs to read or write files on your computer.

If authorization fails

An invalid code is usually expired or already used. Generate a new link and approve it again; authorization codes are short-lived and single-use.

10 · Troubleshooting & FAQ

Mockups stop or return no images mid-run
The universal provider session is verified automatically before each run. If it is unavailable or logged out, contact the ShopPilot administrator.
"AI upscaler is not installed"
Upscayl isn't installed on this PC, or the Bridge can't find it. Install Upscayl, make sure the Bridge is running, and try again. Advanced: set SHOPPILOT_UPSCAYL_BIN if you installed it to a custom path.
A folder shows "server only — not on your PC" but it IS on my PC
If you use the hosted app, the Bridge probably isn't running or is pointed at a different parent folder. Start the Bridge and confirm its folder. Shop Pilot matches renamed PC and server copies by any leading folder ID, including f84, e464, and art12. In local mode, folders read directly from a Windows path are always treated as local.
My listing folder contains more images than the master
That is allowed. Only the files whose names the master records are uploaded; everything else stays in the folder. Pure-number design sources such as 1.png through 5.png are always ignored. A folder is only refused when a file the master names is missing, and the message says which one.
Etsy connect fails with "code is invalid"
Re-open OAuth Setup and start the connection again — the approval code is single-use and short-lived. Make sure the correct Etsy shop is logged in in the browser before approving.
My design came out shrunk / floating in empty space
Auto-prep treats a finished, case-shaped design as final and shows it as-is. If a design still looks off, open it in the Mockup Editor and adjust manually, or AI-upscale it first if it's low-res.
Nothing uploaded but it said "done"
Open Registry and Logs to check the result, then verify the active shop profile and Etsy connection before retrying.
Still stuck? Re-read the relevant section above, then reach out. Good luck — Ralfs

Raw Config Disabled

Direct raw editing is disabled here so the app stops exposing secrets through the browser UI.

Photoshop Phone Case

Generate Photoshop scripts for the older local mockup workflow.

Folders
Source folder
Design folder (output)
Case folder (final)
Cancel flag path
Script output folder
Source = raw designs. Case folder = final output.
Photoshop Actions
Action set name
Save PNG action
Amazon/Case action
Names must match Photoshop Actions exactly.
Batch Settings
File prefix
Batch size
Wait for output (ms)
Increase wait time only if Photoshop exports slowly.
Actions
Drag the generated JSX file into Photoshop.

Curate

Add one or more search themes and ShopPilot will find, score, and cluster matching designs into cohesive sets. Auto Curate descriptions and reference images are optional ways to steer the results more precisely.

Collections

Each collection is a separate aesthetic with its own searches, optional references, settings, and learning — build "Pride Month", "Nature aesthetic", and as many more as you like, side by side.

Style for this collection

The style this collection should use — learned from the designs you pick and tailored to this collection's search queries. The optional Auto Curate batch description does not define this style. Your taste can differ by design type, so each collection gets its own style, and it carries over to similar new collections automatically. Updates as you pick; fully editable. The FAVOR line now actively pulls the image selection toward your taste — so which scraped designs get picked reflects what you keep, not just the search terms; AVOID steers the search terms.

Saves automatically
Auto Curate (optional)
1. References (optional)

Optionally add 3-10 example images to steer the match filter. Search themes work on their own.

2. Cookies (optional)

Without cookies the searches may return limited results. Use the "Get cookies.txt LOCALLY" browser extension while logged in, export, and upload the .txt here.

3. Search queries 0 / 10 searches

One theme per line, up to 10. Themes can be completely different; ShopPilot broadens sparse searches automatically and keeps the resulting sets separated by theme.

4. Tuning Saved automatically
Design target
5. Run
idle
Checking desktop Bridge… Images are collected on this computer before ShopPilot builds sets.
Ready 0%

“Curate collections” asks which collections to include, then runs the ones you tick back-to-back in one job (loads the image matcher once). Collections with no search queries yet cannot be picked. If a curate is interrupted part-way, Continue picks up every collection it did not reach — not just the one on screen.

No run yet.
6. Curated images
No images yet — run the curator above.

Mockups & Design Files

Prepare print-ready designs, or generate iPhone and poster mockups, then save each batch into the next product folder.

Output
1. Designs
Mode
Design images
Phone-case designs go in groups of 5, and each group becomes one new listing folder. On Poster and Smart mockups, each design becomes its own folder.
2. Mockup Templates
Pick the mockup styles this listing should show. The first one is always included.
3. Background swap (optional) Applied to each generated mockup before it lands on disk
Auto-swap background
Background style
Only the main Amazon mockups are changed. The style is saved to the active shop profile.

Auto Orders

No orders yet

Press Check for new orders to load this shop's orders.

Mockup Editor

Edit artwork on an adaptive canvas with layers, selections, brush, crop, transform, and custom export resolution.

Open Canvas adapts to each image

BG Changer

Change mockup backgrounds and save JPGs on a chosen color.

Images
Background colour
Color
Preset
Actions
Recent activityUp to 100 events
Your direct referrals0 customers
CustomerReferralSubscriptionEligible planRateNext estimatePendingValidatedPaid invoicesLifetime benefitNext renewal
Loading direct referrals
Help people you refer with their initial setup and teach them the workflow. ShopPilot support remains available directly to them and to you.
Danger zone