To replace an instrument while keeping its written pitches, use Replace instrument, then correct any pitch shift with a targeted transposition. The current handbook documents these controls separately; it does not describe a keep-written-pitches checkbox.

This guide covers replacing an existing pitched instrument throughout a score in MuseScore Studio on Mac. The goal is to retain the original written note names and octaves while assigning the replacement instrument its proper transposition. The workflow combines the documented replacement and transposition tools; the worked example below explains how to choose the correction. Instrument replacement instructions, Transposition controls.

Decide what must stay the same

Written pitch is the note a musician reads; sounding pitch is the pitch heard. MuseScore Studio normally displays written pitch. Checking Concert pitch in the status bar displays sounding pitch instead. Establish your reference with that box unchecked. Written and concert pitch.

An instrument replacement changes more than its label: the handbook identifies playback, staff name, and transposition among the affected settings. Consequently, preserving written pitches can require changing the underlying musical pitches when the replacement has a different transposition. What instrument replacement changes.

Choose your route before editing:

Your intended result Appropriate route
Assign another instrument and retain the original written notes Replace the instrument, compare the notation, and correct the pitch difference if necessary
Hear another sound while preserving the staff notation Change the channel’s Sound in the mixer
Switch instruments at a particular point in the piece Add an Instrument change element
Keep the original version as well as a replacement arrangement Make a separate working copy before changing musical content

The mixer explicitly supports changing sounds without affecting notation. A mid-score instrument change has its own notation and playback behavior. Mixer documentation, Mid-score instrument changes.

Replace the instrument and establish the correction

1. Record the original written notation

Work in a separate copy if you need to retain the original arrangement. Before replacing anything, record the opening written notes, their octaves, the key signature, and any later key changes. Include a passage with accidentals in your comparison. These checkpoints help distinguish a uniform transposition from an isolated spelling or selection problem.

For example, write down “C4–D4–E4, no sharps or flats,” rather than recording only the notes’ positions on the staff. A change of clef can make a visual comparison misleading; your target is the same written pitches and octaves.

2. Use the instrument’s replacement control

  1. Open the Layout tab. If it is hidden, choose View → Layout.
  2. Find the instrument you want to replace.
  3. Click the cog button beside the instrument’s name.
  4. Click Replace instrument.
  5. Select the replacement and click OK.

These are the handbook’s documented replacement steps. The panel was formerly called Instruments, so older instructions may use that name. Instruments and system markings.

You can also right-click an empty area of the staff or its instrument label, choose Staff/Part properties…, and use Replace instrument there. Keep the replacement’s standard transposition unless you intentionally need a custom instrument definition. Staff/Part properties.

3. Compare before applying another change

With Concert pitch unchecked, compare your recorded notes with the replacement staff. If the pitches already match, no corrective transposition is needed. Otherwise, identify the interval from the current written note back to the original: for example, current D4 to original C4 means a major second down.

Check several notes before proceeding. If the required correction differs between passages, investigate selection boundaries and existing instrument changes instead of applying one interval across everything. The handbook notes that instrument-change elements can affect transposition. Mid-score instrument changes.

Restore the written notes with a targeted transposition

Select only the affected staff’s music: click its first note or rest, then Shift-click its last note or rest. You can navigate between clicks for a selection spanning multiple pages. Inspect the highlighted range to confirm its boundaries. Cmd+A selects the entire score, which is usually too broad for replacing one instrument. Selecting a range.

  1. Choose Tools → Transpose....
  2. Choose chromatic transposition and By interval.
  3. Select Up or Down and the correction interval.
  4. Set Transpose key signatures according to the written keys you need to restore.
  5. Decide whether to transpose chord symbols and fretboard diagrams.
  6. Click OK.

Make the selection first: with no selection, this dialog targets the whole score. Transpose dialog instructions.

Worked example: a non-transposing staff becomes B-flat clarinet

Consider an illustrative original staff with written C4–D4–E4 in C major. A B-flat clarinet sounds a major second below its written pitch; the handbook specifies a major-second-down instrument transposition. Clarinet transposition setting.

If replacement displays D4–E4–F♯4 in D major, the correction is a major second down. Apply that interval to the affected music, including its key signatures. The intended final notation is C4–D4–E4 in C major. With the clarinet’s normal transposition, those written notes then sound B♭3–C4–D4. This is an illustrative calculation from the instrument’s written-to-sounding relationship, not a report of an executed software test.

The resulting sound differs from the original non-transposing staff because the task preserves the written notes. Use the original checkpoints to decide whether that is the arrangement you intended before continuing.

Check key signatures and linked parts

A matching opening note is insufficient if the key signature differs. MuseScore’s key-signature palette represents sounding keys: the handbook’s example says to apply C major to obtain written D major for B-flat clarinet. If you repair a key signature manually, account for that relationship. Key signatures and transposing instruments.

When only the replacement staff needs a different signature from the rest of the score, the documented local-key-signature method is to hold Cmd while applying the palette signature on Mac. Check every later key change, rather than repairing only the first measure. Adding a local key signature.

Pitch edits in a linked part also affect the score, and score pitch edits affect its parts. The part’s Score and part synchronisation controls concern properties such as position and appearance; they do not provide independent note pitches. Therefore, perform the correction once, then inspect both views. Score and part synchronisation.

Open the relevant part through Parts, select it, and click Open selected. Compare its opening notes and later key changes with your reference. Duplicating a part should not be treated as creating an independent musical arrangement: use a separate score copy when the original and replacement need different underlying pitches. This follows from the handbook’s content-synchronisation rule. Opening and duplicating parts.

Recognize version and notation limits

For a sound-only change, choose View → Mixer, find the instrument channel, and open its Sound dropdown. Select the desired sound there. The handbook explicitly states that this leaves notation unchanged, so it does not establish a replacement instrument’s correct clef or transposition. Choosing individual sounds within a SoundFont through this method requires MuseScore 4.2 or later. Changing an instrument’s sound.

Chord-symbol and fretboard-diagram handling is version-sensitive: the official 4.7 announcement identifies their inclusion in score transposition as a 4.7 feature. Older installations should not be assumed to offer identical behavior. MuseScore Studio 4.7 release announcement.

This procedure is scoped to pitched notation. The handbook warns that replacement across staff types, such as a standard pitched staff to drum kit, can produce incorrect playback. Existing Staff type change elements can also cause unpredictable results after replacement. Those cases need separate notation review. Staff types and replacement limitations.

Finish by comparing written note names, octaves, accidentals, key changes, and the linked part with your original checkpoints. Then listen to the replacement. The task is complete when the written material matches your reference and the replacement instrument sounds at its intended transposition.

Sources