Design

Design

The <design> element defines a design file to be used or edited. You can also:
  1. Apply a transform (for placement, rotation, etc).
  2. Modify existing lettering or monogram objects within the design (only with editDesign and editDesignTrueview).

XML structure

<design>
      file="logo1.emb"            // Name of the EMB design file
      colorwaytype="specified"    // Colorway type: current, all, or specified
      colorway="White">           // Name of the colorway 
      <transform ... />           // Optional: transform for the design
      <lettering_objects ... />   // Optional: modify lettering objects
      <monogram_objects ... />    // Optional: modify monogram objects
</design>

Attributes

Attribute
Type
Description
file
String
Name of the EMB file. This file must be included in your <files> list.
colorwaytype
String
Determines which colorway(s) TrueView will return:
  1. current (default): Current colorway only.
  2. all: All colorways — ignored by newDesignTrueview.
  3. specified: Use a specific colorway — name it with colorway.
colorway
String
Name of the colorway to use when colorwaytype='specified'.

Child elements

Element
Description
Optional transform for the design. Ignored by designTrueview.
Use with editDesign or editDesignTrueview to modify existing lettering.
Use with editDesign or editDesignTrueview to modify existing monograms.

Remarks

Lettering and monogram changes:
  1. <lettering_objects> and <monogram_objects> are ignored when using newDesign or newDesignTrueview.
  2. They only work with editDesign and editDesignTrueview.
If colorwaytype=’specified’ and no colorway is given:
  1. newDesignTrueview uses the current colorway.
  2. designTrueview returns an error.
  1. EWA design recipe
  2. EWA API methods overview
  3. EWA data packages overview

    • Related Articles

    • Design Library is missing/not displayed in ES 2025

      ISSUE: The Design Library is missing or not displayed. In ES 2025, after clicking Design Library icon, all you can see are your design thumbnails. Solution: 1. Set your monitor/display resolution to 100% [recommended] 2. If after doing so, and the ...

    • How to resize an embroidery design

      To resize an embroidery design in WilcomWorkspace: Log into WilcomWorkspace. Browse to TrueSizer from the left-side menu 3. Open your embroidery design 4. In the right-side Edit panel, change the Width or Height of the design and press Enter the ...

    • Design status

      The design status setting allows you to define workflow stages used to track the progress of designs. Status values help teams manage design workflows, from initial request through approval and production. Design statuses are shared across the ...

    • View design information

      The Design Information pane displays detailed information about a selected design in the Library. From this pane you can review metadata, inspect technical design properties, view available colorways, and manage attachments associated with the ...

    • Update design information

      The update design information feature allows you to modify the metadata associated with a design in Wilcom Library. Keeping design information up to date ensures designs are easy to find, correctly categorized, and ready for production workflows. ...