You are here: MusicXML Reference > Score Schema (XSD) > Attributes: MusicXML

Attributes: MusicXML

Attributes
Name  Description 
accelerate 
accelerate 
additional  Sometimes clefs are added to the staff in non-standard line positions, either to indicate cue passages, or when there are multiple clefs present simultaneously on one staff. In this situation, the additional attribute is set to "yes" and the line value is ignored.
after-barline  Sometimes clefs at the start of a measure need to appear after the barline rather than before, as for cues or for use after a repeated section.
alternate  The substitution and alternate values are "no" if the attribute is not present.
approach  The approach and departure attributes are used for compound ornaments, indicating how the beginning and ending of the ornament look relative to the main part of the mordent.
attack  The attack and release attributes are used to alter the starting and stopping time of the note from when it would otherwise occur based on the flow of durations - information that is specific to a performance. They are expressed in terms of divisions, either positive or negative. A note that starts a tie should not have a release attribute, and a note that stops a tie should not have an attack attribute.
attribute 
beats  The beats attribute specifies the beats used in a trill-sound or bend-sound. It is a decimal value with a minimum value of 2.
beats  The beats attribute specifies the beats used in a trill-sound or bend-sound. It is a decimal value with a minimum value of 2.
bezier-offset 
bezier-offset2 
bezier-x 
bezier-x2 
bezier-y 
bezier-y2 
blank-page 
bottom-staff  The top-staff and bottom-staff attributes are used when the brace does not  extend across the entire part. For example, in a 3-staff organ part, the top-staff will typically be 1 for the right hand, while the bottom-staff will typically be 2 for the left hand. Staff 3 for the pedals is usually outside the brace.
bracket 
bracket 
bracket  The bracket attribute is used to indicate the presence of a bracket. If unspecified, the results are implementation-dependent. 
bracket-degrees  The bracket-degrees attribute is yes if all the degrees should be in a bracket. If not specified, these values are implementation-specific.
cancel  If the cancel attribute is set to yes, then this number refers to an element specified by the cancel element. It is no by default.
cautionary  While a barline is understood to cancel the effect of an accidental (except for tied notes), publishers often add cautionary accidentals(also referred to as a "courtesy accidental" or "reminder accidental") to notes across the barline to remind the performer of the correct pitch.
coda  The coda attribute works the same way as the one in the sound element. It is used for playback when a barline element contains a coda child element.
coda  Coda and tocoda are used for forward jumps to a coda sign. If there are multiple jumps, the value of these parameters can be used to name and distinguish them.
color 
dacapo  Dacapo indicates to go back to the beginning of the movement. When used it always has the value "yes".
dalsegno  Segno and dalsegno are used for backwards jumps to a segno sign. By default, a dalsegno or dacapo attribute indicates that the jump should occur the first time through. If there are multiple jumps, the value of these parameters can be used to name and distinguish them.
damper-pedal  The damper-pedal, soft-pedal, and sostenuto-pedal attributes effect playback of the three common piano pedals and their MIDI controller equivalents. The yes value indicates the pedal is depressed; no indicates the pedal is released. A numeric value from 0 to 100 may also be used for half pedaling. This value is the percentage that the pedal is depressed. A value of 0 is equivalent to no, and a value of 100 is equivalent to yes.
dash-length 
default-x 
default-x 
default-x 
default-y 
default-y 
default-y 
departure  The approach and departure attributes are used for compound ornaments, indicating how the beginning and ending of the ornament looks relative to the main part of the mordent.
dir 
direction  The up-down attribute is used if there is an arrow on the arpeggio sign. By default, arpeggios go from the lowest to highest note.
direction  The backward-forward attribute is used to specify repeat directions. The start of the repeat has a forward direction while the end of the repeat has a backward direction.
directive 
divisions  The divisions attribute works the same way as the one in the sound element. It is used for playback when a barline element contains a divisions element.
divisions  If segno or coda is used, the divisions attribute can also be used to indicate the number of divisions per quarter note. Otherwise sound and MIDI generating programs may have to recompute this.
dynamics  The dynamics and end-dynamics attributes correspond to MIDI 1.0's Note On and Note Off velocities, respectively. They are expressed in terms of percentages of the default forte value (90 for MIDI 1.0).
dynamics 
editorial 
element 
element 
elevation  The pan and elevation attributes are deprecated in Version 2.0. The pan and elevation elements in the midi-instrument element should be used instead. The meaning of the pan and elevation attributes is the same as for the pan and elevation elements. If both are present, the mid-instrument elements take priority.
enclosure 
end-dynamics  The dynamics and end-dynamics attributes correspond to MIDI 1.0's Note On and Note Off velocities, respectively. They are expressed in terms of percentages of the default forte value (90 for MIDI 1.0).
end-length 
end-length  The length of the jog can be specified using the end-length attribute.
fan  Beams that have a begin value can also have a fan attribute to indicate accelerandos and ritardandos using fanned beams. The fan attribute may also be used with a continue value if the fanning direction changes on that note. The value is "none" if not specified.
filled  The filled attribute can be set to change the hollow/filled appearance of a notehead.
fine  The fine attribute follows the final note or rest in a movement with a da capo or dal segno direction. If numeric, the value represents the actual duration of the final note or rest, which can be ambiguous in written notation and different among parts and voices. The value may also be "yes" to indicate no change to the final duration.
first-beat 
font-family 
font-size 
font-style 
font-weight 
forward-repeat  Forward-repeat is used when a forward repeat sign is implied, and usually follows a bar line. When used it always has the value of "yes".
halign 
height 
id 
id 
id 
id  The optional id attribute refers to the score-instrument assigned to this device. If missing, the device assignment affects all score-instrument elements in the score-part.
id 
id  In multi-instrument parts, the affected instrument should be specified using the id attribute.
id 
id 
implicit  Measures with an implicit attribute set to "yes" never display a measure number, regardless of the measure-numbering setting.
justify 
last-beat 
last-beat 
letter-spacing 
line  The line attribute is yes if pedal lines are used. The change and continue types are used when the line attribute is yes.
line 
line-end  The line-end attribute specifies if there is a jog up or down (or both), an arrow, or nothing at the start or end of the bracket. If the line-end is up or down, the length of the jog can be specified using the end-length attribute.
line-height 
line-shape  The line-shape attribute distinguishes between straight and curved lines.
line-through 
line-type 
location  Barlines have a location attribute to make it easier to process barlines independently of the other musical data in a score. It is often easier to set up measures separately from entering notes. The location attribute must match where the barline element occurs within the rest of the musical data in the score. If location is left, it should be the first element in the measure, aside from the print, bookmark, and link elements. If location is right, it should be the last element, again with the possible exception of the print, bookmark, and link elements.
location  The location attribute indicates whether the alteration should appear to the left or the right of the bass-step; it is right by default.
location  The optional location attribute indicates whether the cancellation appears relative to the new key signature.
location  The location attribute indicates whether the text appears to the left or right of the frame.
location  The optional location attribute indicates which portion of the hole is filled in when the element value is half.
location  The location attribute indicates whether the alteration should appear to the left or the right of the root-step; it is right by default.
long  The long attribute is "no" by default.
make-time  The make-time attribute indicates to make time, not steal time; the units are in real-time divisions for the grace note.
measure  If the measure attribute is set to yes, this indicates this is a complete measure rest.
member-of  The member-of attribute allows for easy distinguishing of what grouping elements are in what hierarchy.
name 
name 
name  The lyric number indicates multiple lines, though a name can be used as well (as in Finale's verse / chorus / section specification).
name 
name 
name 
new-page 
new-system 
niente  The niente attribute is yes if a circle appears at the point of the wedge, indicating a crescendo from nothing or diminuendo to nothing. It is no by default, and used only when the type is crescendo, or the type is stop for a wedge that began with a diminuendo type.
non-controlling 
number 
number  The number attribute can be used to distinguish between two simultaneous chords arpeggiated separately (different numbers) or together (same number). When a number-level value is implied, the value is 1 by default.
number  Each beam in a note is represented with a separate beam element, starting with the eighth note beam using a number attribute of 1. Note that the beam number does not distinguish sets of beams that overlap, as it does for slur and other elements.
number 
number  The optional number attribute refers to staff numbers within the part. A value of 1 is assumed if not present.
number  When a number-level value is implied, the value is 1 by default.
number  The number attribute reflects the numeric values of what is under the ending line. Single endings such as "1" or comma-separated multiple endings such as "1,2" may be used.
number  When a number-level value is implied, the value is 1 by default.
number  The number attribute is used for distinguishing between overlapping and hierarchical groupings.
number  When a number-level value is implied, the value is 1 by default.
number  The optional number attribute refers to staff numbers.
number  The number attribute is a positive integer that refers to the key signature element in left-to-right order.
number  The lyric number indicates multiple lines, though a name can be used as well (as in Finale's verse / chorus / section specification).
number 
number 
number  The optional number attribute specifies the staff number from top to bottom on the system, as with clef.
number 
number  When a number-level value is implied, the value is 1 by default.
number  When a number-level value is implied, the value is 1 by default.
number 
number  The number attribute is used to distinguish overlapping and nested part-groups, not the sequence of groups.
number 
number  When a number-level value is implied, the value is 1 by default.
number  The optional number attribute specifies the staff number from top to bottom on the system, as with clef.
number  The optional number attribute refers to staff numbers within the part, from top to bottom on the system. A value of 1 is assumed if not present. When used in the defaults element, the values apply to all parts. This value is ignored for the first staff in a system.
number  The number attribute is rarely needed to disambiguate ties, since note pitches will usually suffice. The attribute is implied rather than defaulting to 1 as with most elements. It is available for use in more complex tied notation situations.
number  The optional number attribute refers to staff numbers within the part. If absent, the time signature applies to all staves in the part.
number  The optional number attribute refers to staff numbers, from top to bottom on the system. If absent, the transposition applies to all staves in the part. Per-staff transposition is most often used in parts that represent multiple instruments.
number  The number attribute is used to distinguish nested tuplets.
number  When a number-level value is implied, the value is 1 by default.
number  When a number-level value is implied, the value is 1 by default.
orientation 
overline 
page  The page attribute for the credit element specifies the page number where the credit should appear. This is an integer value that starts with 1 for the first page. Its value is 1 by default. Since credits occur before the music, these page numbers do not refer to the page numbering specified by the print element's page-number attribute.
page-number 
pan  The pan and elevation attributes are deprecated in Version 2.0. The pan and elevation elements in the midi-instrument element should be used instead. The meaning of the pan and elevation attributes is the same as for the pan and elevation elements. If both are present, the mid-instrument elements take priority.
parentheses 
parentheses 
parentheses  The parentheses attribute indicates whether or not to put the metronome mark in parentheses; its value is no if not specified.
parentheses  If the parentheses attribute is set to yes, the notehead is parenthesized. It is no by default.
parentheses-degrees  The parentheses-degrees attribute is yes if all the degrees should be in parentheses.
pizzicato  The pizzicato attribute is used when just this note is sounded pizzicato, vs. the pizzicato element which changes overall playback between pizzicato and arco.
pizzicato  Pizzicato in a sound element effects all following notes. Yes indicates pizzicato, no indicates arco.
placement 
plus-minus 
port  The optional port attribute is a number from 1 to 16 that can be used with the unofficial MIDI port (or cable) meta event.
position 
print-dot 
print-frame  The print-frame attribute controls printing of a frame or fretboard diagram.
print-lyric 
print-object 
print-spacing 
reference  If the reference attribute for the level element is yes, this indicates editorial information that is for display only and should not affect playback. For instance, a modern edition of older music may set reference="yes" on the attributes containing the music's original clef, key, and time signature. It is no by default.
relative-x 
relative-x 
relative-x 
relative-y 
relative-y 
relative-y 
release  The attack and release attributes are used to alter the starting and stopping time of the note from when it would otherwise occur based on the flow of durations - information that is specific to a performance. They are expressed in terms of divisions, either positive or negative. A note that starts a tie should not have a release attribute, and a note that stops a tie should not have an attack attribute.
repeater  The repeater attribute has been deprecated in MusicXML 3.0. Formerly used for tremolos, it needs to be specified with a "yes" value for each beam using it.
rotation 
second-beat 
segno  The segno attribute works the same way as the one in the sound element. It is used for playback when barline elements contain a segno element.
segno  Segno and dalsegno are used for backwards jumps to a segno sign. If there are multiple jumps, the value of these parameters can be used to name and distinguish them.
separator  The time-separator attribute indicates how to display the arrangement between the beats and beat-type values in a time signature. The default value is none. The horizontal, diagonal, and vertical values represent horizontal, diagonal lower-left to upper-right, and vertical lines respectively. For these values, the beats and beat-type values are arranged on either side of the separator line. The none value represents  no separator with the beats and beat-type arranged vertically. The adjacent value represents no separator with the beats and beat-type arranged horizontally.
separator  The time-separator attribute indicates how to display the arrangement between the beats and beat-type values in a time signature. The default value is none. The horizontal, diagonal, and vertical values represent horizontal, diagonal lower-left to upper-right, and vertical lines respectively. For these values, the beats and beat-type values are arranged on either side of the separator line. The none value represents  no separator with the beats and beat-type arranged vertically. The adjacent value represents no separator with the beats and beat-type arranged horizontally.
show-frets  Indicates whether to show fret numbers or fret letters. If not specified, numbers is used.
show-number  The show-number attribute is used to display either the number of actual notes, the number of both actual and normal notes, or neither. It is actual by default.
show-number  The show-number attribute is used to display either the number of actual notes, the number of both actual and normal notes, or neither. It is actual by default.
show-type  The show-type attribute is used to display either the actual type, both the actual and normal types, or neither. It is none by default.
sign  The sign attribute is yes if Ped and * signs are used. For MusicXML 2.0 compatibility, the sign attribute is yes by default if the line attribute is no, and is no by default if the line attribute is yes.
size 
size  The size attribute is used for clefs where the additional attribute is "yes". It is typically used to indicate cue clefs. The after-barline attribute is set to "yes" in this situation. The attribute is ignored for mid-measure clefs. 
size  The size attribute indicates full, cue, or large size, with full the default for regular notes and cue the default for cue and grace notes.
size  A size of 8 indicates one octave; a size of 15 indicates two octaves.
slash  The slash attribute for a grace note is yes for slashed eighth notes.
slash  If the slash attribute is yes, then a vertical line is used to slash the turn; it is no by default.
slashes  The slashes attribute specifies the number of slashes to use in the symbol. By default, the value for slashes is 1. 
slashes  The slashes attribute specifies the number of slashes to use in the repeat sign. It is 1 if not specified.
soft-pedal  The damper-pedal, soft-pedal, and sostenuto-pedal attributes effect playback of the three common piano pedals and their MIDI controller equivalents. The yes value indicates the pedal is depressed; no indicates the pedal is released. A numeric value from 0 to 100 may also be used for half pedaling. This value is the percentage that the pedal is depressed. A value of 0 is equivalent to no, and a value of 100 is equivalent to yes.
sostenuto-pedal  The damper-pedal, soft-pedal, and sostenuto-pedal attributes effect playback of the three common piano pedals and their MIDI controller equivalents. The yes value indicates the pedal is depressed; no indicates the pedal is released. A numeric value from 0 to 100 may also be used for half pedaling. This value is the percentage that the pedal is depressed. A value of 0 is equivalent to no, and a value of 100 is equivalent to yes.
sound  If the sound attribute is "yes", then the offset affects playback too. If the sound attribute is "no", then any sound associated with the direction takes effect at the current location. The sound attribute is "no" by default for compatibility with earlier versions of the MusicXML format.
source 
space-length 
spread  Spread values are measured in tenths; those at the start of a crescendo wedge or end of a diminuendo wedge are ignored.
stack-degrees  The stack-degrees attribute is yes if the degree elements should be stacked above each other.
staff-spacing 
start-note 
steal-time-following  The steal-time-following attribute indicates the percentage of time to steal from the following note for the grace note, as for appoggiaturas.
steal-time-previous  The steal-time-previous attribute indicates the percentage of time to steal from the previous note for the grace note.
string  Strings are numbered from high to low.
substitution  The substitution and alternate values are "no" if the attribute is not present.
substitution  The substitution value is "no" if the attribute is not present.
symbol 
symbol  A separate symbol attribute value is available compared to the time element's symbol attribute, which applies to the first of the dual time signatures.
symbol  The symbol attribute indicates the type of symbol used at the start of the principal-voice.
symbol  The symbol attribute is used indicate common and cut time symbols as well as a single number display.
tempo 
text  The text attribute indicates how the bass should appear in a score if not using the element contents.
text  The text attribute specifies how the type of the degree should be displayed in a score.
text  The text attribute specifies how the type of the degree should be displayed in a score.
text  The first-fret type indicates which fret is shown in the top space of the frame; it is fret 1 if the element is not present. The optional text attribute indicates how this is represented in the fret diagram.
text  The text attribute describes how the kind should be spelled in a score. If use-symbols is yes, the value of the text attribute follows the symbol.
text  The text attribute indicates how the root should appear in a score if not using the element contents.
text-x  The text-x and text-y attributes are offsets that specify where the baseline of the start of the ending text appears, relative to the start of the ending line.
text-y  The text-x and text-y attributes are offsets that specify where the baseline of the start of the ending text appears, relative to the start of the ending line.
time-only  If a note is played only particular times through a repeat, the time-only attribute shows which times to play the note.
time-only  If the sound element applies only particular times through a repeat, the time-only attribute indicates which times to apply the sound element.
time-only  If the tie element applies only particular times through a repeat, the time-only attribute indicates which times to apply it.
times  Backward repeats that are not part of an ending can use the times attribute to indicate the number of times the repeated section is played.
tip 
tip 
tocoda  Coda and tocoda are used for forward jumps to a coda sign. A tocoda attribute indicates the jump should occur the second time through. If there are multiple jumps, the value of these parameters can be used to name and distinguish them.
top-staff  The top-staff and bottom-staff elements are used when the brace does not  extend across the entire part. For example, in a 3-staff organ part, the top-staff will typically be 1 for the right hand, while the bottom-staff will typically be 2 for the left hand. Staff 3 for the pedals is usually outside the brace.
trill-step  The trill-step attribute describes the alternating note of trills and mordents for playback, relative to the current note.
two-note-turn  The two-note-turn attribute describes the ending notes of trills and mordents for playback, relative to the current note.
type 
type  The type is "start" for the lowest pitched string (e.g., the string with the highest MusicXML number) and is "stop" for the highest pitched string.
type 
type 
type 
type  The type attribute defines what type of distance is being defined. Valid values include hyphen (for hyphens in lyrics) and beam.
type 
type  The optional type attribute was added in Version 3.0 to provide better formatting control.
type  The type attribute represents the type of the feature and the element content represents its value.
type 
type 
type 
type 
type 
type  The type attribute defines what type of line is being defined. Values include beam, bracket, dashes, enclosure, ending, extend, heavy barline, leger, light barline, octave shift, pedal, slur middle, slur tip, staff, stem, tie middle, tie tip, tuplet bracket, and wedge.
type  Both the start and the stop of the measure-repeat must be specified. The text of the element is ignored when the type is stop.
type 
type 
type  The grace type is used for notes of cue size that that include a grace element. The cue type is used for all other notes with cue size, whether  defined explicitly or implicitly via a cue element. The large type is used for notes of large size.
type 
type 
type 
type 
type  The type attribute is not needed when used as part of a print element. If omitted when the page-margins type is used in the defaults element, "both" is the default value.
type 
type 
type 
type  The type attribute indicates whether this is the start or stop of a slash notation style.
type 
type 
type 
type  The type attribute indicates if the point of the accent is down or up.
type 
type 
type 
type 
type 
type 
type 
type  The type attribute is crescendo for the start of a wedge that is closed at the left side, and diminuendo for the start of a wedge that is closed on the right side.
underline 
unplayed  The frame type's unplayed attribute indicates what to display above a string that has no associated frame-note element. Typical values are x and the empty string. If the attribute is not present, the display of the unplayed string is application-defined.
use-dots  The use-dots attribute indicates whether or not to use dots as well (for instance, with mixed rhythm patterns). By default, the value for use-dots is no. 
use-dots  The use-dots attribute works as it does for the beat-repeat element, and only has effect if use-stems is no.
use-stems  To indicate rhythms but not pitches, use-stems is set to yes. If the slash is on every beat, use-stems is no (the default).
use-symbols  The use-symbols attribute is yes if the kind should be represented when possible with harmony symbols rather than letters and numbers. These symbols include: major: a triangle, like Unicode 25B3 minor: -, like Unicode 002D augmented: +, like Unicode 002B diminished: °, like Unicode 00B0 half-diminished: ø, like Unicode 00F8. For the major-minor kind, only the minor symbol is used when use-symbols is yes. The major symbol is set using the symbol attribute in the degree-value element. The corresponding degree-alter value will usually be 0 in this case.
use-symbols  The use-symbols attribute indicates which to use; it is no if not specified.
valign  The valign attribute is used to indicate vertical alignment to the top, middle, bottom, or baseline of the text or image. Defaults are implementation-dependent.
valign  The valign attribute is used to indicate vertical alignment to the top, middle, bottom, or baseline of the text or image. Defaults are implementation-dependent.
value 
version 
width 
width 
winged 

 

MusicXML Documentation Home
Last built 2/20/2015

7007 Winchester Circle, Suite 140

Boulder, CO 80301