Sheet fields

Functions that show a drawing's information: in a border's texts (and its barcodes, and its variables), what the drawing it is placed in on a sheet holds; anywhere else, what the drawing itself holds.

Syntax

HOST("name")                HOST("name",sample)
HOSTNOTE("key")             HOSTNOTE("key",sample)
HOSTCLASS("field")          HOSTCLASS("field",sample)
DRAWINGTITLE()              DRAWINGNAME()             DRAWINGFILE()             DRAWINGUNITS()
PAGENAME()                  VIEWPAGE()                VIEWPAGE(n)               VIEWPAGE("name")
SHEETNO()                   SHEETCOUNT()              SHEETSCALE()              SHEETSCALE(n)
TODAY()                     TODAY("format")

Function	Gives
`HOST("L")`	The value of the drawing's variable L.
`HOSTNOTE("Customer")`	The drawing's note of that name (File › Drawing Properties), any case.
`HOSTCLASS("category")`	A field of the drawing's classification: `category`, `style`, `product`, `tags`, `description` or one of your own.
`DRAWINGTITLE()`	The drawing's Title note; without one, its file's name.
`DRAWINGNAME()`, `DRAWINGFILE()`	The drawing's file name without its folder and extension, and with its extension.
`DRAWINGUNITS()`	`"mm"` or `"in"`.
`PAGENAME()`	The name of the sheet's page (of the page worked on, outside a sheet).
`VIEWPAGE()`	The page a sheet's first viewport shows; `VIEWPAGE(2)` the second's, `VIEWPAGE("Detail")` the one of that name.
`SHEETNO()`, `SHEETCOUNT()`	Which sheet it is (from 1) and how many there are: of the pages with a sheet on them; in a drawing without sheets, of its pages (3D pages left out).
`SHEETSCALE()`	The scale of a sheet's first viewport, as `"1:2"`; a fitted view's is worked out (`"1:2.37"`). With a number or a name, as VIEWPAGE.
`TODAY()`	Today's date, as `2026-11-03` (ISO 8601); with a format, as it says: `TODAY("dd.MM.yyyy")`.

The sample is what is shown where the drawing hasn't the thing: HOSTNOTE("Drawing number",DRAWINGNAME()) shows the drawing's name until it is given a Drawing number note.

Result

Text, or for HOST the variable's value; SHEETNO() and SHEETCOUNT() give numbers.

Examples

In the example drawing, which has no notes and isn't saved:

Expression	Gives
`HOST("W")`	`300`
`HOST("FLAP",25)`	`25`
`HOSTNOTE("Customer")`	`"<Customer>"`
`HOSTNOTE("Revision","-")`	`"-"`
`HOSTCLASS("style")`	`"<style>"`
`DRAWINGNAME()`	`"<Drawing name>"`
`DRAWINGUNITS()`	`"mm"`
`PAGENAME()`	`"Page 1"`
`CONCAT("Sheet ",SHEETNO()," of ",SHEETCOUNT())`	`"Sheet 1 of 1"`
`SHEETSCALE()`	`"1:1"`

Notes

Placeholders. In a drawing on its own (a border you are editing), a field the drawing hasn't shows a placeholder in angle brackets, as above, so you can see what goes where. On a sheet, it shows the sample if one is given, else nothing.

On a sheet the fields are worked out again whenever what they show changes: give the drawing a note, rename a page, add a sheet, change a scale or a variable, and the sheet follows.

A drawing's own FUNCTION of the same name is used instead of one of these.

More expressions