Skip to content

Etsy category and fields cheat sheet for DTF transfers

A DTF transfer is something a buyer presses onto a garment, so on Etsy it fits the supplies side rather than the finished-item side. That choice drives the category, the supply flag, the maker fields, the listing type and the weight. This page gives the exact values Etsy's API accepts for each one.

Last updated July 28, 2026

Etsy will not create a draft without these

The draft-listing endpoint marks seven fields required: quantity, title, description, price, who_made, when_made and taxonomy_id. A shipping_profile_id joins them once the listing type is physical. Everything else on this page is optional to Etsy, which is not the same as unimportant to a buyer.

Etsy's rulePublished in Etsy's public API specification(opens in a new tab). Checked July 28, 2026.
taxonomy_id

Category

Required

Etsy describes it as: “The numerical taxonomy ID of the listing.”

Etsy's rulePublished in Etsy's public API specification(opens in a new tab). Checked July 28, 2026.

The path Mirra walks down

  1. Craft Supplies & Tools
  2. Canvas & Surfaces
  3. Stencils, Templates & Transfers
  4. Image Transfers

Pick the leaf in Etsy's own category picker rather than typing an ID. Etsy assigns the number, changes the tree on its own schedule, and the picker is the only place the current wording is guaranteed to be right.

Mirra's own ruleNot an Etsy rule. Etsy publishes no rule putting DTF transfers in one category. This is the leaf Mirra defaults to, because a transfer is pressed onto something else rather than sold finished. If what you sell is closer to a finished item, choose the leaf that describes it and ignore this one.
is_supply

Supply or finished product

Optional

Etsy describes it as: “When true, tags the listing as a supply product, else indicates that it's a finished product. Helps buyers locate the listing under the Supplies heading. Requires 'who_made' and 'when_made'.

Etsy's rulePublished in Etsy's public API specification(opens in a new tab). Checked July 28, 2026.

Values Etsy accepts

  • truea supply
  • falsea finished product

Mirra sends true unless you change it.

Mirra's own ruleNot an Etsy rule. Etsy takes either value and states no preference. Mirra sends true because a transfer is a component the buyer presses onto a garment, and Etsy's own wording ties this flag to the Supplies heading buyers browse. Switch it off if you sell the pressed garment rather than the transfer.
who_made

Who made it

Required

Etsy describes it as: “An enumerated string indicating who made the product. Helps buyers locate the listing under the Handmade heading. Requires 'is_supply' and 'when_made'.

Etsy's rulePublished in Etsy's public API specification(opens in a new tab). Checked July 28, 2026.

Values Etsy accepts

  • i_did
  • someone_else
  • collective

Answer it about the transfer, not the artwork, and answer it honestly: this is the field Etsy hangs its Handmade heading on. Note the underscores. Etsy's own listing form shows these as plain-English choices, and sending the label instead of the value is a rejection.

when_made

When it was made

Required

Etsy describes it as: “An enumerated string for the era in which the maker made the product in this listing. Helps buyers locate the listing under the Vintage heading. Requires 'is_supply' and 'who_made'.

Etsy's rulePublished in Etsy's public API specification(opens in a new tab). Checked July 28, 2026.

Values Etsy accepts

  • made_to_order
  • 2020_2026
  • 2010_2019
  • 2007_2009
  • before_2007
  • 2000_2006
  • 1990s
  • 1980s
  • 1970s
  • 1960s
  • 1950s
  • 1940s
  • 1930s
  • 1920s
  • 1910s
  • 1900s
  • 1800s
  • 1700s
  • before_1700

Mirra sends made_to_order unless you change it.

Mirra's own ruleNot an Etsy rule. Etsy accepts any of the nineteen and recommends none. Mirra sends made_to_order because a transfer printed after the order comes in was, in plain terms, made to order. A seller printing a stocked run in advance should say so instead.
type

Physical or digital

Optional

Etsy describes it as: “An enumerated type string that indicates whether the listing is physical or a digital download.

Etsy's rulePublished in Etsy's public API specification(opens in a new tab). Checked July 28, 2026.

Values Etsy accepts

  • physical
  • download
  • both

A pressed-and-posted transfer is physical, and Etsy then requires a shipping_profile_idon the listing. A design file the buyer prints themselves is a download, which is a different listing with different buyer expectations. Etsy's draft endpoint is documented as creating a physical draft, so a download listing does not start the same way.

materials

Materials

Optional

Etsy describes it as: “A list of material strings for materials used in the product. Valid materials strings contain only letters, numbers, and whitespace characters.

Etsy's rulePublished in Etsy's public API specification(opens in a new tab). Checked July 28, 2026.

The character rule here is stricter than the one for tags. Letters, numbers and spaces only: no hyphen, no apostrophe, no ampersand, no slash. So DTF ink is fine and DTF-ready film is rejected. Write what the transfer is actually made of and leave the field empty rather than padding it with keywords.

item_weight / item_weight_unit

Shipping weight

Optional

Etsy describes it as: “The numeric weight of the product measured in units set in 'item_weight_unit'. Default value is null. If set, the value must be greater than 0.

Etsy's rulePublished in Etsy's public API specification(opens in a new tab). Checked July 28, 2026.

Etsy publishes no weight for a DTF transfer, and neither does Mirra. Put one transfer in the mailer you actually ship, weigh the lot, and type that. The number below is yours: it stays in this browser, and this page never suggests one for you.

Units Etsy accepts for item_weight_unit

Which Etsy category does a DTF transfer belong in?

Category is the one required field on this page that nobody can answer for you in advance, because it decides which shoppers ever see the listing. Etsy sorts its whole catalogue into a tree, and a listing sits on exactly one leaf of it. A DTF transfer is a component: the buyer presses it onto a shirt, a tote or a hat, and the transfer on its own is not the thing they will wear. That puts it on the supplies branch, alongside stencils, vinyl and iron-ons, rather than in clothing.

Mirra defaults to the Image Transfers leaf under Craft Supplies & Tools, and the sheet above shows the full path so you can walk down to it in Etsy's own category picker. Use the picker rather than a number copied from anywhere, including from Mirra. Etsy owns the numbering, reshapes the tree on its own schedule, and the picker is the only place the current wording is guaranteed correct on the day you list.

Nothing about this is an Etsy instruction. Etsy publishes no page saying DTF transfers go here. It is a judgement about what the product is, and if you sell the pressed garment rather than the transfer, the judgement flips and so does the category.

Is a DTF transfer a supply or a finished product?

Etsy asks this as a single flag, and its own description of the field is blunt about the effect: true tags the listing as a supply product, false indicates a finished product, and the answer decides whether shoppers browsing the Supplies heading find it. The field also refuses to travel alone. Etsy's specification says it requires both maker fields alongside it, so a listing cannot set one of the three and skip the rest.

For a transfer that ships to a buyer who presses it themselves, the supply answer follows from what the product is. That is why Mirra sends it, and it is Mirra's call rather than a rule: Etsy accepts either value without comment. The moment your shop starts shipping pressed shirts, the shirt is the finished product and the flag is wrong.

What do the maker fields mean for a transfer you printed?

Who made it and when it was made are both required, and Etsy will not create the draft without them. They are also the two fields sellers most often get wrong, because they read like paperwork and are actually the inputs to Etsy's Handmade and Vintage headings. Etsy says so in the field descriptions themselves.

Answer them about the transfer in the buyer's hand. Who ran the printer, and when. If a production partner printed it, the honest answer is not the same as if you printed it in your garage, and Etsy has separate rules about production partners that this page does not cover. When it was made has nineteen accepted values, most of them decades for vintage sellers; a transfer printed after the order arrives is made to order, which is why Mirra sends that one.

Watch the spelling. Every value is lower case with underscores, and Etsy's own seller form displays them as ordinary English phrases. Retyping what the form shows instead of what the API takes produces a rejected request with a message that does not obviously point at the field.

Should the listing be physical or a digital download?

Etsy accepts three answers here: physical, download, or both. A printed transfer you put in an envelope is physical, and Etsy then requires a shipping profile on the listing before it will publish. A design file the buyer prints on their own printer is a download, which skips shipping entirely and comes with completely different buyer expectations, refund behaviour and file-format questions.

The distinction is worth stating plainly because the two are sometimes sold from the same artwork. Selling the file is not the same business as selling the transfer, even when the design is identical. Etsy documents its draft-listing endpoint as creating a physical draft, so a download listing does not start life the same way, and Mirra pushes physical transfer listings.

What goes in materials and shipping weight?

Both are optional, and both have a trap. Materials looks like a free-text field and is not: Etsy accepts only letters, numbers and whitespace in a material string, which is stricter than the rule it applies to tags. A hyphen or an ampersand that sails through as a tag is rejected as a material. Write what the transfer is made of, in plain words, and leave the field empty rather than stuffing keywords into it.

Weight is the one field on this page where the right answer is a measurement rather than a value from a list. Etsy publishes no weight for a transfer, there is no figure for it anywhere in Mirra, and any source quoting you a typical weight for a DTF transfer is guessing on your behalf. Weigh one transfer in the mailer you actually ship. Etsy takes oz, lb, g or kg, stores the number and the unit as two separate fields, and requires the number to be greater than zero if you set it at all.

What does this cheat sheet not do?

It does not check your listing. Nothing here reads a draft, connects to your shop or looks at anyone else's listings. It is a reference page: the fields, the values Etsy accepts, and a note on each one saying whether the choice is Etsy's rule or Mirra's opinion.

It does not tell you the numeric category ID, and that is deliberate: Etsy assigns the number, and the picker in your own shop is where you should read it. It does not check your title or your tags, it does not tell you what to charge, and it does not cover Etsy's separate rules about production partners. It is also a snapshot. Etsy can change any of these values, so the date above is part of the information rather than decoration.

Common questions

Do I have to put a DTF transfer in the Image Transfers category?

No. Etsy publishes no rule assigning DTF transfers to one category, and the category field takes any leaf in Etsy's tree. Craft Supplies & Tools then Canvas & Surfaces then Stencils, Templates & Transfers then Image Transfers is the path Mirra defaults to, because a transfer is pressed onto something else rather than sold finished. If you sell the finished garment, pick the leaf that describes the garment instead.

Which who_made value should I pick for a transfer I printed myself?

Answer it about the transfer rather than the artwork, and answer it accurately. Etsy accepts three values, i_did, someone_else and collective, and uses the answer to decide whether the listing belongs under its Handmade heading. Nobody outside your shop can tell you which one is true, and an inaccurate answer is a policy problem rather than a validation error, so it will not show up as a rejected request.

Why do the field values have underscores in them?

Because those are the strings Etsy's API accepts. Etsy's own listing form shows the same choices as plain English, so a seller reading the form sees I did while the API expects i_did. Copying the label out of the form and sending it to the API gets the request rejected. The values on this page are the API spelling, copied out of Etsy's specification without changes.

What weight should I put on a DTF transfer listing?

Whatever one transfer weighs in the packaging you actually ship. Etsy publishes no figure for this and neither does Mirra, so any number quoted to you as typical is a guess. Put a transfer in its mailer, weigh it, and enter that. Etsy accepts oz, lb, g and kg as units, and the weight has to be greater than zero if you set it at all.

Does Etsy reject a listing that has no materials listed?

No. Materials is optional and defaults to empty. The rule worth knowing is the character rule: material strings accept only letters, numbers and whitespace, which is stricter than the rule for tags. A hyphen, an apostrophe, an ampersand or a slash in a material is rejected, so DTF ink passes and DTF-ready film does not.

Does anything I type on this page get sent to Etsy or to Mirra?

No. This page is static and the tool on it runs entirely in your browser. There is no form submission, no upload and no account. The weight you type stays on your machine, and closing the tab discards it. Mirra measures page views across the site the way most sites do, which is separate from anything you type into the tool.

Every field name, description and accepted value on this page was read out of Etsy's public API specification on the date shown above. Etsy can change them without telling anyone, so treat the date as part of the answer and check the specification if something is rejected. Mirra is not affiliated with Etsy.

Where a choice is Mirra's rather than Etsy's, the sheet says so and gives the reason. Disagree with the reason and pick something else: Etsy accepts every value listed.

This tool runs in your browser. Nothing you type here is uploaded. Mirra measures page views across the site, the way most sites do, and that is separate from what you type into the tool.