Specifies a setup name that includes a group of settings to use for printing. The setup is created by a user of the printer. Depending on the printer vendor, the setup name might be referred to as "printer setup", "printer snapshot" or "printer profile".

GUI label

Setup name




Resettable, single-valued, per-job

Allowed Values

Any string text up to 100 bytes.

Default Value

No default value

Usage Guidelines

  • The value you specify for this attribute overrides any selection in the form definition.
  • If the setup name is not already the active setup on the printer, the start auxiliary sheet does not print using the requested setup name for the job.
  • If the setup name requested for a job is not already the active setup name on the printer, the printer ejects to a new sheet and stacks all received pages. This can result in a blank sheet while printing in cut sheet emulation (CSE) mode, a blank side if duplex is used, or a blank partition if N-up is being used.
  • The setup-name attribute is used together with the setup-names-ready actual destination attribute.