About Embroidery Formats

About Embroidery Formats

In the Wilcom Web API service most API calls return an “embroidery” file. This Article provides background information on this topic.



Wilcom developed a “native” internal embroidery design format in EmbroideryStudio, called the EMB file which is the file extension for Wilcom designs. Therefore, Wilcom’s own designs have the format of “design-name.EMB”.

Embroidery machines however have their own formats, and accordingly, different file extensions, for example Tajima has .DST, Happy has .TAP, Melco has .EXP, Barudan has .U??, SWF has .EBD, therefore Wilcom EmbroideryStudio users can export their designs in the format that is most suitable for their embroidery machine.



The EMB format is an object-based, so called “all-inclusive” format. It contains every object, their outline shape, their creation information, graphic shape type, color, their embroidery properties, like stitch type, densities, underlays, pull compensation and also some machine functions, like thread trimming, or thread tension change or needle selection (where the machine has this feature). The user always can edit any of the object properties and therefore can re-create the object any time. In addition, the EMB format also contains the generated stitches.

The machine files on the other hand are simple stitch files with machine stops where the stop usually means to select a different color/needle. They are not editable, not scalable (well it is not recommended to scale a stich file by more than 10% otherwise the stitch quality will be unacceptable. Some machine manufacturers support needle numbers, thread trimming, Borer functions, Schiffli machine codes even support thread tension and machine speed changes.



The most typical question is: what file format do we request from the server?

The typical line in the xml instructions looks like this:

<output trueview_file=”DesignName.png” design_file=”DesignName.emb” />

This line requests both the Trueview image and the embroidery file in Wilcom EMB format.

But for example, if you want a Tajima or Melco format, you would write:

<output trueview_file=”DesignName.png” design_file=”DesignName.DST” />

<output trueview_file=”DesignName.png” design_file=”DesignName.EXP” />



Depending on what function you need from the embroidery engine sometimes you need to use EMB files.

A good example is if you want to edit Lettering in a Wilcom EMB file This cannot be done in a machine file. The call used here is the api/editDesign. The line in the call could be similar to this below:

<design file=”designname.EMB” colorwaytype=”all” />

(just indicating here that the Wilcom EMB file also can handle multiple colorways in the same design file.)

    • Related Articles

    • Resizing an embroidery design

      To resize an embroidery design in WilcomWorkspace: Log into WilcomWorkspace. Browse to Studio from the left-side menu Open your embroidery design In the right-side Edit panel, change the Width or Height of the design and press Enter the apply the ...
    • Embroidery Connect Device Setup Video

      Click this link to open the Video on how to setup the Embroidery Connect Device Link - Embroidery Connect Device Setup Video
    • Colors in Embroidery Machine Stitch Files and the Wilcom Default Color Palette

      Wilcom API Support Note: Colors in Embroidery Machine Stitch Files and the Wilcom Default Color Palette INTRODUCTION – A STITCH FILE HAS NO COLOR INFORMATION Please click on the attachment below to read through the document.
    • Embroidery Machine Serial Connection Information

      Machine Connections can be handled in a number of ways: 1) If your embroidery machine comes with machine connection software, such as, Ricoma PC Communication Software(EMB_soft.exe) for Ricoma embroidery machine, or "Happy Link" software for Happy ...
    • Embroidery Design Size and Stitch Count

      This document is prepared for Web developers or Wilcom API customers with only printing background, who are not familiar with the embroidery technology. We have received many questions about why the stitch count increases with the increase of the ...