Skip to content
Docs
Sign in

Item properties

Key and value pairs on each item, such as coating or customer, that ganging rules match on: setting, importing and limits.

A property is a key and a value on an item, such as "Coating = Gloss UV" or "Customer = C-102". Ganging rules use properties to decide which items may share a form (see Ganging rules: what may share a form).

Kinds of property#

Key Label Value
stock Stock Text, such as "100 lb Silk". Different stocks print on separate forms of the same sheet size. An item on a library material takes the material as its Stock (below).
coating Coating Text; suggestions none, aqueous gloss, aqueous matte, UV gloss, UV matte, soft touch, varnish.
finishing Finishing Text, such as guillotine, laminate or fold.
customer Customer Text. Items without one take the job's customer.
order Order Text: an order or batch reference.
due Due A date (YYYY-MM-DD), or a date and time. Items without one take the job's due date.
group Gang group Text. Always matched: items gang only with the same group.

Derived keys are filled in by the app and can't be set: Sides (1 or 2), Inks (the item's inks per side), Finishes (foil, emboss, spot UV) and Product type. A rule may match on them, for example to keep colour- critical items that must share exact inks together.

Custom properties are declared by your team on the Ganging rules page, with a label and a type: text, number, date or a list of choices. An item may also carry keys nobody declared (through the API or an import); they show as "Undeclared" and can be matched once declared.

Own sheet is a switch on the item: it gets forms of its own, shared with nothing else.

Material#

Material, at the top of the item's Properties, names the stock the item is ordered on, from your Materials library (see Materials and stocks). It's optional: None (choose the media when you run) keeps everything as before, with the sheet or roll and its cost set on the Media card.

When items have a material:

  • Items on the same material nest together, and different materials never share a sheet. The material is the item's Stock (shown read-only, marked "From the material"), and Stock is matched whenever any item of the job has a material, even if your ganging rules don't match on it. Items without a material keep their own Stock text, or none.
  • The material's size is the job's media. A sheet material with a width and length sets the sheet size, and a roll material with a width sets the roll width with its side margins, lead-in and lead-out. Those fields are read-only on the Media card, which names the material. Change them in the library, or clear the items' material.
  • The material's cost is used. When every material of the job costs the same per sheet (or per ft² on a roll), it becomes the job's sheet or roll cost. Either way the Report prices each form by the material on it: one sheet of that material per sheet printed (on offset, makeready and spoilage included), as the job's sheet cost would. A form of items without a material uses the job's sheet cost. When the materials cost differently, solution cards show no quick estimate: their cost appears once the Report has priced them.
  • One sheet size or roll per job. A run nests on one sheet size or one roll, so materials of different sizes or forms can't run together: Run says which ones differ. Make one job per size, or pick materials of one size. A roll holds one stock, so on a roll every item needs the same material.
  • Runs on. A material marked Digital only can't go on an offset run, and Offset only can't go on a digital one.

A material without a size (for example board made to size) still keeps its items apart from other materials; the Media card's size is used, and its price per ft² or m² is worked out on that sheet size.

The rule applies to every method (True shape, N-up, Strips) and to offset runs, where each material is planned on plates of its own. Set the material for several items at once with Set material in the bulk edit, or through the API (material on the item, see Imposition API).

Setting them#

  • In the item inspector, one item at a time.
  • For several items at once, with the bulk edit: set or clear the material, one property, Own sheet, Keep together or declared inks.
  • By importing a file (below).
  • Through the imposition API: the item's properties object (see Imposition API).

Values and limits#

  • At most 32 properties per item; keys are lowercase letters, digits and _, up to 40 characters, starting with a letter. Keys starting with x_ or sys_ are kept for integrations.
  • Text is at most 120 characters. Numbers are compared as numbers: 1, 1.0 and 1.00 are one value. Dates are ISO. True / false isn't a value: use a choice.
  • Comparisons ignore case and extra spaces; the text you entered is kept for display.
  • An empty value deletes the key. A missing value counts as "not set", its own value.

Over %, Under % and dies#

On offset jobs every item has its own Over and Under % in the item list. Empty fields use the job's Press run values (shown greyed), so a job without them plans as before. An item at 0 % and 0 % gets exactly its quantity. Items that fit a die on hand carry a die chip: green when the die is used as is, amber for a near match you confirm on the Tooling card.

Importing properties#

Import a CSV file (UTF-8, comma or semicolon separated, with a header row) or JSON rows with the same names. Each row names its item in the artwork column, by id or by a name that is unique in the job.

Column Meaning
artwork The item: its id or its name.
quantity The ordered quantity.
stock, coating, finishing, customer, order, due, group The built-in properties.
own_sheet yes or no.
split inherit, allow or never (see Keeping items together).
front_inks, back_inks Declared inks per side, such as 4+PMS 185 C or K.
prop:<key> A custom property, such as prop:lamination.

An empty cell leaves the value as it is; - clears it. Unknown columns are an error, so a typo never vanishes. When two rows name the same item the later one wins, with a warning. An import is a dry run first: it lists every change (item, field, from, to) and any row errors. Applying writes every row or none. At most 2,000 rows and 2 MB per file.

artwork,coating,customer,own_sheet,front_inks
Postcard A,Gloss UV,C-102,no,4+PMS 185 C
Postcard B,Matte,C-207,yes,4

Tooling columns#

The import also takes an item's overrun and its die:

Column Meaning
over_pct or max_overrun The item's Over %, 0 to 500.
under_pct The item's Under %, 0 to 50.
min_overrun A minimum overrun, as some workflows write it: a negative value is an underrun (-5 = Under 5 %).
die A die's number (the die the quote was priced on: the job shows "Quoted on" and uses it), a single-up's name, or the file name of a single-up's source file. An unknown name is a row error.
artwork,over_pct,under_pct,die
Carton 200 A,10,0,D-2001
Carton 200 B,0,0,

Attach CAD files (the API's cad-files action) takes several single-up CF2 or DXF files and gives each to the item whose name matches the file name, as that item's single-up.

Last updated Oct. 17, 2026