Tokens in Dorico

Version 3.5.10, November 2020

Tokens can only be used in text frames, not in text items you create with Shift+X or Shift+Alt+X.

Tokens not specific to project/flows

Token Description
{@page@} Page number
{@pageCount@} Total number of pages in the layout
{@playernames@} Player names
{@playerlist@} Player list
{@layoutname@} Layout name (i.e. shown in the Layouts panel in Setup mode)
{@layoutnumber@} Layout number (i.e. shown in the Layouts panel in Setup mode)

Project tokens
Token Description
{@projectFileName@} File name of the project
{@projectFilePath@} File path of the project

Project-wide fields in File▸Project Info

Token Description
{@projecttitle@} Project title
{@projectsubtitle@} Project subtitle
{@projectdedication@} Project dedication
{@projectcomposer@} Project composer
{@projectarranger@} Project arranger
{@projectlyricist@} Project lyricist
{@projectartist@} Project artist
{@projectcopyist@} Project copyist
{@projectpublisher@} Project publisher
{@projecteditor@} Project editor
{@projectcopyright@} Project copyright
{@projectworknumber@} Project work number
{@projectcomposerdates@} Project composer dates
{@projectcompositionyear@} Project composition year
{@projectotherinfo@} Project other info
Per-flow fields in File▸Project Info
The following tokens will display the value for the flow that begins or continues in the first music frame
on the page on which the token is used:

Token Description
{@flowtitle@} Flow title
{@flowsubtitle@} Flow subtitle
{@flowdedication@} Flow dedication
{@flowcomposer@} Flow composer
{@flowarranger@} Flow arranger
{@flowlyricist@} Flow lyricist
{@flowartist@} Flow artist
{@flowcopyist@} Flow copyist
{@flowpublisher@} Flow publisher
{@floweditor@} Flow editor
{@flowcopyright@} Flow copyright
{@flowworknumber@} Flow work number
{@flowcomposerdates@} Flow composer dates
{@flowcompositionyear@} Flow composition year
{@flowotherinfo@} Flow other info

Alternatively, you can insert the flow’s number as shown at the bottom right-hand corner of the Flows
panel in Setup mode between flow and the following word, for example {@flow2title@} will display the
title of the second flow in the project.

Per-flow page count tokens

Token Description
{@flowPage@} Number of this page within the current flow, counting from 1
{@flowPageCount@} Total number of pages in the current flow
{@flownFirstPage@} The displayed page number on which flow n begins

Per-flow duration tokens

Token Description
{@flowDuration@} Duration of the current flow in minutes and seconds
{@flownDuration@} Duration of flow n in minutes and seconds
Flow number tokens
Token Description
{@flownumber@} Flow number (as shown in the Flows panel in Setup mode)
{@flowInLayoutNumber@} Flow number (within the current layout)
{@flowNumberRomanLower@} Flow number, shown as a lower-case Roman numeral
{@flowNumberRomanUpper@} Flow number, shown as an upper-case Roman numeral

Music symbol tokens

Token Description
{@flat@} Flat accidental
{@sharp@} Sharp accidental
{@natural@} Natural accidental
{@gClef@} G clef (treble)
{@fClef@} F clef (bass)
{@cClef@} C clef (alto/tenor/soprano/baritone)
{@U+E4C0@} Fermata above

(You can enter the code point for any SMuFL symbol between the {@ @} parts of tokens. The SMuFL
specification is available here. You can also include music symbol tokens in fields in the Project Info
dialog.)

Staff label tokens

Token Description
{@staffLabelsFull@} Full (long) staff labels of players in current layout
{@staffLabelsShort@} Abbreviated (short) staff labels of players in current layout

Date and time tokens

Token Description Example
Standard date and time string (locale Sun Dec 31 11:10:12
{@date@}
dependent) 2017
{@dateyear@} Four-digit year 2017
{@dateyearshort@} Two-digit year 17
{@datemonth@} Full month name (locale dependent) October
{@datemonthshort@} Short month name (locale dependent) Oct
{@datemonthnum@} Month as a decimal number, range 1-12 10
{@dateday@} Full weekday name (locale dependent) Friday
 Token Description Example
Abbreviated weekday name (locale
{@datedayshort@} Fri
dependent)
Day of month as decimal number, range 1-
{@datedaynum@} 24
31
{@dateymd@} ISO8601 date 2017-12-31
{@datemdy@} Month day, year December 31, 2017
{@datedmy@} Day month year 31 December 2017
{@datetime@} Time representation (locale dependent) 11:10:12
{@datetimeHHMM@} Hours:minutes, hour in 24-hour clock range 23:10
{@datetimeHHMMSS@} Hours:minutes, hour in 12-hour clock range 11:10
{@datetimehour24@} Hour in 24-hour clock range 23
{@datetimehour12@} Hour in 12-hour clock range 11
{@datetimeminute@} Minute as decimal number, range 00-59 10
{@datetimesecond@} Second as decimal number, range 00-59 44

The following tokens display the date and time at which the project was last saved:

Token Description Example

Standard date and time string Sun Dec 31 11:10:12
{@projectdate@}
(locale dependent) 2017
{@projectdateyear@} Four-digit year 2017
{@projectdateyearshort@} Two-digit year 17
{@projectdatemonth@} Full month name (locale dependent) October
Short month name (locale
{@projectdatemonthshort@} Oct
dependent)
Month as a decimal number, range
{@projectdatemonthnum@} 10
1-12
Full weekday name (locale
{@projectdateday@} Friday
dependent)
Abbreviated weekday name (locale
{@projectdatedayshort@} Fri
dependent)
Day of month as decimal number,
{@projectdatedaynum@} 24
range 1-31
{@projectdateymd@} ISO8601 date 2017-12-31
Token Description Example
{@projectdatemdy@} Month day, year December 31, 2017
{@projectdatedmy@} Day month year 31 December 2017
Time representation (locale
{@projectdatetime@} 11:10:12
dependent)
Hours:minutes, hour in 24-hour
{@projectdatetimeHHMM@} 23:10
clock range
Hours:minutes, hour in 12-hour
{@projectdatetimeHHMMSS@} 11:10
clock range
{@projectdatetimehour24@} Hour in 24-hour clock range 23
{@projectdatetimehour12@} Hour in 12-hour clock range 11
Minute as decimal number, range
{@projectdatetimeminute@} 10
00-59
Second as decimal number, range
{@projectdatetimesecond@} 44
00-59