Getting started
First run, what you need before you begin, and how long things take.
I've just signed up. What's the shortest route to my first mockup?
Four steps, and only the first one is a one-off. Upload a PSD template, give it artwork, pick which frames to render, and collect the ZIP. Nothing is published anywhere until you choose to publish it.
- Frames → upload the PSD template you own. PSDmate finds the Smart Object layer itself.
- Generate → upload your artwork file, or type a prompt and let the AI draw it.
- Tick the frames you want and press Generate.
- History → download the ZIP when the run finishes.
Do I need Photoshop installed?
Not to render. PSDmate reads the Smart Object layer server-side and applies your artwork through the template's own transform, so nothing is installed on your machine. You only need an editor to build or repair a template — and there is a free Photopea editor built into the Projects page for that.
Open ProjectsDoes PSDmate give me mockup templates, or do I bring my own?
You bring your own — bought from Creative Market, Envato or Etsy, or shot yourself. That is deliberate rather than a gap: templates from a shared library show up in thousands of other shops, and identical scenes sitting side by side on an Etsy search page cost you the click.
What do I actually get on the free plan?
Five mockup renders a month and no AI image generations. The free plan opens the dashboard home, Generate, Frames, Projects, History and Settings. Bulk runs, Etsy publishing, video, finance and research are paid features — opening one of those pages sends you back to the dashboard rather than showing a broken screen.
See what each plan includesHow long does a render take?
A normal run of 8–10 frames finishes in roughly 2–5 minutes. A full bulk run — up to 50 artworks against every frame — usually takes 15–40 minutes depending on queue load and how heavy the PSDs are. A live progress grid shows each frame as it completes.
Can I close the tab while a job is running?
Yes. Rendering happens on the server, not in your browser. Close the tab, shut the laptop, come back later — the run carries on and the results wait for you in History.
Open HistoryI pressed Generate and nothing seems to be happening. Is it broken?
Probably not. The render server sleeps when nobody is using it and takes about a minute to wake up, so the first job after a quiet spell sits at "queued" longer than the rest. If a job is still queued after 15 minutes, that is worth reporting.
Where do my finished files end up?
Every run is saved to History with its ZIP, the original artwork, and the frames it used. You can re-download the ZIP at any time, or send the same artwork back through frames you have added since.
PSD templates & frames
What a template needs, why one might be rejected, and how to fix it.
What does my PSD have to contain for this to work?
One embedded Smart Object acting as the artwork slot. That is the whole requirement. PSDmate reads the slot's own transform — its scale, rotation and warp — so your design lands in the scene the way the template author intended.
I got "No target smart object layer found in PSD". What now?
PSDmate walked the layer tree and found nothing it could safely treat as the artwork slot. Almost always this is a linked Smart Object rather than an embedded one, or a flattened template with no Smart Object at all.
- Open the PSD in Projects (or Photoshop) and check the artwork layer really is a Smart Object, not a flattened raster.
- If it is linked to an external file, convert it: Layer → Smart Objects → Convert to Embedded. Linked Smart Objects cannot be read server-side.
- Rename the slot layer to one of the names PSDmate recognises — artwork, design, placeholder, input, poster, print, smart object or your design.
- Re-upload. If it still fails, send us the file and we will look at the layer tree.
How big can a PSD be, and how many can I upload at once?
Up to 500 MB per file, ten files per upload batch. Uploads go straight to storage through a signed URL rather than through the app, so a large file will not time out on the way. If you drop more than ten in at once, the first ten upload and the rest are skipped with a message.
My artwork replaced the room in the photo instead of the frame on the wall. Why?
That template stores its background photograph as a Smart Object too, so there were two candidates and the wrong one won. It is common in flat "frame pack" PSDs. PSDmate now spots a full-canvas placed layer and retargets away from it, but a template with an unusual layer tree can still confuse it.
- Open the PSD and rename the layer you actually want filled to "artwork".
- Re-upload the template — the name takes priority over everything else.
My PSD has several Smart Objects. Which one gets my design?
A confirmed Smart Object beats a name-only match, and among equals the recognised names win in order: input, magic, artwork, placeholder, design, smart object, your design, poster, print. If several are still tied, PSDmate uses the first and logs a warning. Renaming the one you want to "artwork" settles it for good.
Can I fix a broken template without buying Photoshop?
Yes. The Projects page has a Photopea editor embedded in it — a free browser Photoshop clone. Renaming a stubborn Smart Object layer or re-embedding a linked one takes about a minute there, and you never leave PSDmate.
Open ProjectsDo I have to re-upload the template for every design?
No. A template is uploaded once and becomes a reusable frame. Every design you ever make can be pushed through it. Group frames into a layout and one run produces every size and scene variation of a design at once.
Open FramesMy print looks like a flat sticker sitting on the t-shirt. Can PSDmate fix that?
Not on its own — that is the template, not the renderer. Realistic fabric needs a displacement map baked into the PSD so the print follows the folds; ceramics need a cylindrical warp; canvas needs the wrapped edge. PSDmate applies whatever transform the Smart Object carries, so a template built with displacement renders with displacement. When buying templates, that is the thing to check.
Template checklists by productArtwork & design prompts
Writing prompts that produce sellable art, and what to do when one does not.
What actually makes a good design prompt?
Specificity in five places. A prompt that names the subject, the style, the palette, the composition and the background gives the model almost nothing left to guess at. A prompt that names only the subject leaves it guessing at four things, and it will guess differently every time — which is why runs feel inconsistent.
- Subject — what is in the picture: "a red fox, side profile".
- Style — how it is drawn: "minimalist line art", "1950s travel poster", "loose watercolour".
- Palette — the colours you want to sell: "cream, charcoal, muted terracotta".
- Composition — where things sit: "centred, generous negative space, full-bleed".
- Exclusions — what must not appear: "no text, no watermark, no border".
Show me a weak prompt and a strong one, same idea.
Weak: "fox poster". Strong: "A1 poster, minimalist line-art red fox in side profile, cream background, thin charcoal strokes, generous negative space, muted terracotta accent, full-bleed, no text, no watermark, no border." The second one is repeatable — run it ten times and you get ten pieces that belong in the same collection.
Why does my AI artwork have gibberish writing on it?
Image models cannot spell. They have learned that posters usually carry lettering, so they produce letter-shaped noise unless told not to. Add "no text, no watermark, no border" to the end of every prompt. PSDmate's prompt expander already asks for full-bleed, print-ready artwork with no text — but a prompt of your own that mentions a "poster" or a "sign" will invite lettering straight back in.
Do I need to pay for an API key to generate artwork?
No. Free FLUX models are built in and need no key at all — they are the default. Adding your own key in Settings unlocks the paid models (fal.ai, Gemini, OpenRouter and others) at their cost with no markup on top. Keys are encrypted at rest and only ever used for jobs you start.
Add a key in SettingsIf the model is free, why does it still come off my allowance?
The allowance meters generations, not spend — the server time is ours either way. Free plan 0 AI images, Starter 10, Pro 40, Studio 150 per month. Mockup renders are metered separately, so generating artwork does not eat into your render allowance or the other way round.
What happens if the free image model is busy when I hit Generate?
PSDmate moves down its chain of free models rather than giving up on the first refusal, and takes a second pass after a short pause if the whole first pass was rate-limited. A busy model costs you a few seconds, not the run. If genuinely every free model is busy you will get a plain-English message telling you to wait a few minutes — not raw provider JSON.
Can I give the AI a reference image instead of describing everything?
Yes — pick an image-to-image model such as FLUX Kontext or FLUX Dev img2img on the Generate page and attach your reference. Those are paid models, so they need your own fal.ai key in Settings. You can also point the prompt at just one aspect of the reference, for example "focus on the animal, ignore the background".
Can I save a prompt I like and reuse it?
Yes. Save it as a prompt template on the Generate page with a name like "Vintage Travel Poster", then apply it to any new subject. That is how a collection stays visually consistent across thirty designs instead of drifting.
Open GenerateWhat size and resolution should my own artwork be?
Bigger than the slot it lands in. Outputs come out at 3000px and up, so artwork smaller than the Smart Object gets upscaled and softens. PNG, JPG and WebP are all accepted. If you are selling printables, run the file through the free DPI checker before you list it.
Free print file checkerMy PNG was rejected with "Invalid SVG image" — but it is definitely a PNG.
It is, and the error is lying to you. Photoshop, Firefly and Lightroom attach Content Credentials to exports, and inside that data sits a small SVG preview which the image decoder finds and mistakes for the real file. PSDmate now strips that data and retries automatically, so this should heal itself. If a file still fails, re-export it with Content Credentials turned off, or open and re-save it in Photopea.
Renders & bulk runs
What counts as a render, what happens when part of a run fails, and how to recover.
What counts as one mockup against my allowance?
One frame rendered. One artwork across eight frames is eight mockups. Allowances are Free 5, Starter 100, Pro 500 and Studio 2500 a month. The count is taken when the job is accepted, so a frame that fails to enqueue is not charged to you.
Why can I not use bulk mode?
Bulk is a Pro feature. Pro takes 15 artworks per run, Studio takes 50. On Starter and Free you can still render one artwork against every frame you own — bulk changes how many artworks go in at once, not how many frames come out.
Compare plansOne artwork failed halfway through a run. Have I lost the whole batch?
No. Items are rendered independently, so a failure is contained to that frame or that artwork. The failed item shows its error message in the run and can be re-rendered on its own; everything that succeeded is already in your ZIP.
My job has been sitting at "queued" for a long time.
The first job after an idle period waits for the render server to wake, which takes about a minute. After that, jobs queue behind other jobs — a heavy bulk run ahead of you is the usual explanation. Past 15 minutes with no movement, email us the approximate time you started it and we will look at the worker logs.
Can I cancel a bulk run I started by mistake?
Yes — Cancel run on the Bulk page. It stops the run and deletes the mockups it generated, but keeps the posters you uploaded, so you can fix the settings and start again without re-uploading anything.
Do the outputs have a watermark or a size limit?
No watermark on any plan, including free. Outputs are full-resolution PNGs at 3000px and up, delivered as a single ZIP per run.
Can I run last year's bestsellers through frames I bought since?
That is one of the better habits available to you. Open the run in History, keep the artwork, pick your new frames, and generate again. Old designs in new scenes are the cheapest new listings you will ever make.
Open HistoryDoes the order of my outputs mean anything?
Yes — outputs follow the order of the frames in your layout, and that order carries through to the images attached to an Etsy listing. Drag frames into the order you want buyers to see before you render, rather than reordering images in Etsy afterwards.
Etsy publishing
Connecting your shop, what publishing does, and the two errors Etsy sellers hit most.
How do I connect my Etsy shop?
Settings → Connected Apps → Connect Etsy Shop. Etsy's own consent screen opens and asks whether you want to let PSDmate create listings for you. Your Etsy password is never seen by us; the token that comes back is encrypted at rest and only used for actions you trigger.
Open Connected AppsWill anything go live in my shop without me approving it?
No. Every listing PSDmate creates is a draft. Drafts do not appear to buyers, do not cost a listing fee, and stay put until you activate them in Etsy. If you publish thirty listings and hate all thirty, nothing has happened to your shop.
Where does the listing copy come from?
A vision model reads the actual rendered mockup image — the scene, the colours, the room it is hanging in — and writes a title, a description and all 13 tags from what it can see. That is why the copy describes your image rather than reading like a filled-in template. Review and edit it in the Queue before publishing.
Publishing failed: "OpenRouter's free vision models are all rate-limited right now."
The free listing-copy models were all busy at once, which happens when a big run fires many items at the same moment. Nothing is wrong with your account, your shop or your images.
- Wait a few minutes and publish the run again — items already published are skipped, so nothing duplicates.
- To stop it recurring, turn on "Use my OpenRouter credits" in Settings.
- Or add a Gemini API key in Settings as a fallback — it takes over whenever the free models are busy.
Etsy said "Exceeded per second rate limit".
Etsy limits how many requests any app may make per second, and a large publish or a big listings refresh can touch it. It is transient and it is not a penalty against your shop — wait a moment and retry. If it happens on every attempt, tell us what you were doing at the time.
A bulk publish stopped part way through. Can I just run it again?
Yes, and you should. Re-running skips the items that already reached Etsy and picks up only the ones that did not, so a run that got 30 of 50 listings out finishes the remaining 20 without creating duplicates.
My Etsy connection stopped working after a while.
Etsy access tokens expire, and a shop owner can also revoke access from Etsy's side. Reconnecting takes seconds: Settings → Connected Apps → Connect Etsy Shop again. Nothing in PSDmate is lost when the connection lapses — only live shop actions pause.
What happens to my listings if I disconnect Etsy or delete my PSDmate account?
Listings already created live in Etsy and belong to you — they are unaffected. Disconnecting only stops PSDmate reading your sales and creating new drafts. Your mockups, frames and history stay in PSDmate until you delete them.
Can PSDmate fill the listing video slot too?
Yes. Generate a slideshow video from the run's mockups and it is attached to the listing along with the images. Listings with video hold attention longer, which is worth the extra minute on your hero designs at least.
Video
Slideshow videos for Etsy and Instagram.
What do I get when I generate a video?
A 1080 × 1080 MP4 at 30fps, around ten seconds, with fade transitions between your mockups. It comes in under 15 MB — comfortably inside Etsy's 100 MB limit — and needs no editing software or skills at your end.
Can I control the music, timing and order?
Yes — pick the track, the transition and the slide order on the Video page, and save the combination as a preset so every listing in a collection moves the same way. Presets you save are available on the Generate page too.
Open VideoVideo is greyed out for me.
Video is a Pro feature, along with bulk runs, finance and the AI listing tools. Starter covers exports, Etsy publishing and niche research.
Compare plansPlans, limits & billing
What each plan includes, when counters reset, and what the limit messages mean.
What does each plan actually include?
Free: 5 mockups a month, no AI images, no bulk. Starter ($19/month, £15): 100 mockups, 10 AI images, exports, Etsy publishing, niche research. Pro ($32/month, £25): 500 mockups, 40 AI images, bulk runs up to 15 per run, video, finance, AI listing copy, integrations. Studio ($63/month, £50): 2500 mockups, 150 AI images, bulk up to 50 per run. Paying annually costs ten months rather than twelve.
Full comparisonWhen does my monthly counter reset?
On paid plans it follows your billing period, not the calendar — so upgrading mid-month resets against your invoice date rather than handing you a second free allowance. On the free plan it resets on the first of the calendar month.
I hit a message saying "Plan limit reached". What does that mean exactly?
You have used your monthly allowance of that thing — renders and AI images are counted separately. The counter clears at the start of your next period, or you can move up a tier for a bigger allowance. Nothing you have already made is affected.
A different message told me to upgrade to unlock a feature. Is that the same thing?
No, and the difference matters. "Limit reached" means you have used up an allowance you do have. "Upgrade to unlock" means your plan does not include that feature at all — bulk, video, finance and the AI listing tools are Pro and above. The first one fixes itself next month; the second one does not.
I clicked a dashboard page and got sent back to the dashboard home.
That page is not in your plan. The free plan reaches the dashboard home, Generate, Frames, Projects, History and Settings. Rather than showing you a screen full of locked buttons, PSDmate returns you to a page you can use.
Can I earn credit for recommending PSDmate?
Yes — there is a referral scheme in Settings with a link that is yours. Share it and referrals are attributed to you when someone signs up through it. The scheme is reachable on the free plan too.
Settings → ReferralsHow do I cancel, and do I get a refund?
Cancel any time from your account settings; your plan runs to the end of the period you have paid for. Payments are final and we do not offer refunds except where the law requires it — the Terms set this out in full. If you cannot find the cancel option, email us and we will do it for you.
Read the TermsAccount, data & privacy
Where your files live, who can see them, and how to leave.
Who can see my templates and my designs?
Only you. Templates, artwork, outputs and runs are scoped to your account at the database level, not just hidden in the interface. Nothing you upload is added to a shared library or shown to other sellers.
How are my API keys and my Etsy connection stored?
Encrypted at rest, and used only for jobs you start. We never see your Etsy password — the connection is OAuth, so Etsy holds the credentials and hands us a revocable token. You can revoke it from Etsy at any time, or disconnect from Connected Apps.
How do I delete my account and everything in it?
Email PSDmate@proton.me with the subject "Delete my account". Everything is removed within 30 days. Listings already created in your Etsy shop belong to you and stay there.
Can I get my files out before I go?
Yes. Every run in History keeps its ZIP, and the export tools download your outputs in bulk. Do that first — once deletion runs, the stored copies are gone.
The interface is too bright or too dark for me.
Settings has a theme switch, and every page in PSDmate honours it — including this help centre, which follows whatever your device or browser is set to.
Open SettingsNone of this answers my question.
Then write to us at PSDmate@proton.me and say what you were doing, what you expected, and what happened instead. We reply within one business day. If a job failed, the approximate time you started it is enough for us to find it in the logs.
Error messages, decoded
The exact wording PSDmate shows you, what it actually means, and the fix.
| Message | What it means | What to do |
|---|---|---|
No target smart object layer found in PSD | Nothing in the layer tree could be treated as the artwork slot — usually a linked Smart Object, or a flattened template. | Convert the slot to an embedded Smart Object and rename it "artwork", then re-upload. |
Invalid SVG image | Your PNG carries Adobe Content Credentials, and the SVG preview hidden inside them confused the image decoder. | It usually recovers by itself on retry. If not, re-export with Content Credentials off, or re-save the file in Photopea. |
<file> exceeds 500MB per-file limit | One PSD in the batch is over the per-file ceiling. | Flatten unused layers or delete hidden variants in Photoshop or Photopea and re-save. |
Max 10 files per upload | You dropped more than ten templates at once. The first ten are uploaded. | Upload the rest as a second batch — nothing was lost. |
Only PNG, JPG, WebP, GIF allowed | An artwork file is in a format the renderer cannot read — commonly a PDF, a TIFF or a stray .psd. | Export the design as PNG at full size and try again. |
OpenRouter's free vision models are all rate-limited right now | The free listing-copy models were busy at the moment your run needed them. Not an account problem. | Wait a few minutes and publish again — published items are skipped. Or add your own OpenRouter credits or a Gemini key in Settings. |
Exceeded per second rate limit | Etsy throttled the request. It is transient and carries no penalty against your shop. | Retry in a moment. Re-running a publish skips anything already created. |
Plan limit reached | The monthly allowance for renders or AI images is used up. The two are counted separately. | Wait for the reset at the start of your next period, or move up a plan for a bigger allowance. |
Unauthorized | Your sign-in expired while the tab was open. | Reload the page and sign in again. Anything already queued keeps running. |
Still stuck?Email PSDmate@proton.me with what you were doing, what you expected, and what happened instead — plus roughly when, if a job failed. We reply within one business day. For how each feature works end to end, read the docs or the Etsy guide.
Contact support →