psd.to.designDocs

psd.to.design docs

Last updated

What it is

psd.to.design converts Adobe Photoshop (.psd and .psb) files into editable Figma designs — through a Figma plugin, a web tool, or the ‹div›RIOTS API.

OptionOutput
Figma pluginFigma layers
Web toolFigma layers via clipboard
APIFigma layers, JSON, or a flattened image

Figma plugin requires Figma open; the web tool and API don't. Full output details, including all API formats, in Output.

What it does

Drop in a .psd or .psb file. psd.to.design reads its Photoshop layer structure — groups, text, shapes, images, blend modes, and effects — and rebuilds it as native Figma layers, preserving as much of the original editability as the import mode allows, from a single flattened image up to fully editable layers (see Output, below).

Where it runs

The plugin runs inside Figma — you'll need Figma open to use it (Figma Community).

The web app runs in your browser, at divriots.com/psd.to.design — no Figma required. Accepts drag-drop or click-to-browse uploads.

The ‹div›RIOTS API runs wherever you call it from — any backend or app that can make an HTTP request. Same engine, exposed as the psd input format. Metered separately — see Pricing. Full reference: ‹div›RIOTS API documentation.

Supported input formats

FormatExtension
Photoshop Document.psd
Photoshop Large Document.psb

.psd and .psb are supported across both the plugin and the API.

Output

Figma plugin — import modes

Every import goes through one of two modes, trading full editability for a single flattened image:

ModeWhat you get
Fully editable (recommended)Text, images, effects, patterns, and shapes all import as editable layers — text stays editable, shapes stay vector.
Flattened in a single image layerThe whole file imports as one flat image layer, no layer structure.

The plugin places each import in its own section on the current page, next to your existing content.

Web tool

The web tool runs the same conversion engine as the plugin and imports fully editable layers: text, images, and shapes stay editable, and shapes stay vector. Copy the result and paste it into Figma.

API

Three output formats are available for the psd input type — the image output is unique to psd among the document inputs:

Output formatWhat it isCredits
figma-clipboardData to load into the clipboard and paste onto the Figma canvas2
figma-restJSON, structurally compatible with the Figma REST API2
imageThe document flattened to a single PNG at 1:12

Full reference: ‹div›RIOTS API documentation.

Editability

ElementBehavior
Layer groupsPhotoshop's folder structure converts to Figma frames and groups, hierarchy preserved.
Layer namingLayer names carry over as-is.
Layer visibilityHidden layers stay hidden.
Raster layersImport as high-quality raster images.
Shape layersConverted to vector objects when possible.
Adjustment layersNot supported — imported as an invisible placeholder layer, flagged in its name. (Gradient-map adjustments keep their gradient colors.)
Text layersFully editable, with font family and style (when available in your Figma fonts), size, spacing, line height, and basic text effects preserved. Missing fonts are flagged, with substitution options offered.
Blend modesScreen, Multiply, Overlay and the other blend modes Figma supports carry over. Photoshop-only modes with no Figma equivalent (Dissolve, Hard Mix, Subtract, Divide) are dropped; Pin/Vivid/Linear Light fall back to Overlay.
OpacityLayer and fill opacity are preserved.
Layer masksBoth vector and pixel (raster) masks convert to Figma's native masking system — raster masks come in as luminance masks.
Layer stylesDrop shadows, inner shadows, glows, strokes, and color/gradient/pattern overlays translate to equivalent Figma effects. Bevel & Emboss is approximated with inner shadows; Satin isn't supported.
Smart ObjectsFlattened to raster images — not preserved as editable Figma components.
Gradient fillsMulti-stop gradients are preserved with their original color stops.
Pattern fillsImport as tiled image fills, not flattened into the composite. Very large or missing pattern tiles fall back to a placeholder.

This table describes the Fully editable import mode — the other mode trades all of this away for a single flattened image (see Output, above).

Limits

LimitValue
Adjustment layers & Smart ObjectsNot preserved as editable — dropped or flattened
Unsupported effects & blend modesSatin layer style; Dissolve, Hard Mix, Subtract & Divide blend modes
File size10 GB max in the web tool, on every plan; Figma plugin: 500 MB max (free tier), 10 GB max (paid ‹div›RIOTS ONE)

No hover states, animations, or other interactive behavior are inferred — conversion works from the static layer data in the file only.

Privacy & processing

  • The Figma plugin, the web app and the API convert your file on the ‹div›RIOTS API. The file is stored only for the processing, then deleted, and never used for training.
  • Anonymous usage analytics are captured (on api.divriots.com) to improve the experience.
  • If an import fails, you can choose to send that one file to us for debugging; nothing is uploaded unless you click that button.

Terms and privacy policies for ‹div›RIOTS products are published at divriots.com/legal.

Pricing

The Figma plugin and web tool are included in ‹div›RIOTS ONE:

OptionPricing
‹div›RIOTS ONE — FreeFigma plugin: 5 imports, files up to 500 MB each. Web tool: 2 credits per file, files up to 10 GB
‹div›RIOTS ONE — ProFigma plugin: 1 credit per import, no import cap, files up to 10 GB each. Web tool: 2 credits per file, files up to 10 GB
APIMetered per call — psd input reserves 2 credits/call for any output format (figma-clipboard, figma-rest, or image) — see Output, above

One subscription across every ‹div›RIOTS product — psd.to.design included — with a shared credit balance you top up as needed.

Explore plans

How to use

Figma plugin

  1. Open your Figma file, launch psd.to.design from the plugins menu.
  2. Drag and drop your .psd or .psb file into the plugin, or click to browse.
  3. Choose an import mode — Fully editable or Flattened in a single image layer.
  4. Click Import.
  5. Your design lands in its own section on the current page, layer structure intact — edit directly on the canvas.

Web tool

  1. Go to divriots.com/psd.to.design.
  2. Drop your .psd or .psb file, or click to browse.
  3. Copy the result as Figma layers to paste into Figma.

API

  1. Generate an API key from your ‹div›RIOTS ONE dashboard.
  2. Send a request to the /convert endpoint with input: psd and a chosen output format — figma-clipboard, figma-rest, or image.
  3. The conversion runs as a background job: the call returns 202 Accepted with a Location header. Poll GET /convert/jobs/{jobId} until status is done, then download the result from resultUrl (a signed URL valid ~15 min; re-poll for a fresh one if it expires).

Full reference: ‹div›RIOTS API documentation.

FAQ

What file types does psd.to.design support?

.psd and .psb — Adobe Photoshop’s standard and large-document formats.

Does it preserve my layer structure?

Yes — folders convert to Figma frames and groups with hierarchy intact, layer names carry over, and hidden layers stay hidden.

What happens to my fonts?

Text imports as fully editable Figma text, matched against your available Figma fonts. Missing fonts are flagged, with substitution options offered.

Are blend modes preserved?

Most are — Screen, Multiply, Overlay and the other blend modes Figma supports carry over. A few Photoshop-only modes have no Figma equivalent: Dissolve, Hard Mix, Subtract, and Divide are dropped, and Pin/Vivid/Linear Light fall back to Overlay.

What about layer masks?

Yes. Photoshop has two types of layer mask, and psd.to.design supports both: vector masks convert to Figma's native masking system, and pixel (raster) masks come in as luminance masks.

What about layer styles like drop shadows and glows?

Drop shadows, inner shadows, glows, strokes, and color/gradient/pattern overlays translate to equivalent Figma effects. Bevel & Emboss is approximated with inner shadows, and Satin isn’t supported.

What happens to Smart Objects?

They’re flattened to raster images — Smart Objects aren’t preserved as editable Figma components.

Can I get HTML output instead of Figma layers?

No — psd.to.design only produces Figma-compatible output: layers via the plugin or web tool, or figma-clipboard, figma-rest, or a flattened image via the API. For HTML output from an image, see image.to.design.

Can I use psd.to.design without Figma?

Yes — the web tool at divriots.com/psd.to.design runs the same conversion engine without needing Figma open. Copy the result as Figma layers via clipboard.

Does it work with Figma's Dev Mode?

Yes — once converted, standard Figma functionality applies, including Dev Mode inspection, prototyping, and component libraries.

Is psd.to.design free?

It’s included in ‹div›RIOTS ONE. The Figma plugin’s free tier gives you 5 imports, files up to 500 MB each; paid ‹div›RIOTS ONE plans import at 1 credit each, with no import cap and files up to 10 GB each. The web tool costs 2 credits per file, with files up to 10 GB on every plan. The API is credit-metered per call.

Can I import large PSB files?

Yes — .psb is supported alongside .psd, up to 10 GB per file in the web tool on every plan; the Figma plugin takes 500 MB on the free tier, or 10 GB with a paid ‹div›RIOTS ONE plan.

Support

Need a hand, hit a bug, or have a PSD that doesn’t convert the way you expect? Email us at [email protected]. Attaching the PSD (or a screenshot of the result) helps us help you faster.

See also