> For the complete documentation index, see [llms.txt](https://handbook.musescore.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://handbook.musescore.org/3/notation/slurs.md).

# Slurs

A **slur** is a curved line between two or more notes indicating that they are to be played *legato*—smoothly and without separation. Not to be confused with [Ties](/3/notation/ties.md), which join two notes of the same pitch.

There are a number of ways to add a slur to a score, and all may be useful depending on the context (adding a slur from the [lines palette](/3/notation/lines.md) is also possible but not recommended).

## Add slur in note-input mode

1. While in [**Note input mode**](/3/basics/note-input.md#step-2-enter-note-input-mode), type in the first note in the slurred section;
2. Press <kbd>S</kbd> to begin the slurred section;
3. Type in the remaining notes in the slurred section;
4. Press <kbd>S</kbd> again to end the slurred section.

## Add slur in Normal mode

### Method 1

1. Make sure you are in [Normal mode](/3/appendix/glossary.md#normal-mode);
2. Select the note where you want the slur to start:

   <figure><img src="/files/HI2DKkvEOcDlKrq6VcyR" alt="First note selected"><figcaption></figcaption></figure>
3. Press <kbd>S</kbd> to add a slur extending to the next note:

   <figure><img src="/files/LA5micOTsp8IZ2IynPOt" alt="Slur to adjacent note"><figcaption></figcaption></figure>
4. (Optional) Hold <kbd>Shift</kbd> and press <kbd>Right</kbd> (right arrow key) to extend the slur to the next note. Repeat as required:

   <figure><img src="/files/DqouK5y4psZGT36Acnhw" alt="Three-note slur"><figcaption></figcaption></figure>
5. (Optional) Press <kbd>X</kbd> to flip the slur direction:

   <figure><img src="/files/lNDpcW91SEJvifBIbgGl" alt="Slur above note stems"><figcaption></figcaption></figure>
6. Press <kbd>Esc</kbd> to exit [**edit mode**](/3/basics/edit-mode.md):

   <figure><img src="/files/VALNxGzF6Nbuh86C0ZCi" alt="Slur no longer in edit mode"><figcaption></figcaption></figure>

### Method 2

1. Make sure you are in [Normal mode](/3/appendix/glossary.md#normal-mode);
2. Select the note where you want the slur to start;
3. Choose one of the following options:
   * To add a slur to one voice *only*: Hold down <kbd>Ctrl</kbd> (Mac: <kbd>Cmd</kbd>) and select the last note that you want the slur to cover.
   * To add slurs to *all* voices: Hold down <kbd>Shift</kbd> (Mac: <kbd>Cmd</kbd>) and select the last note that you want the slurs to cover.
4. Press <kbd>S</kbd>.

## Adjust slur

If you only want to adjust the *position* of a slur:

1. Select the slur;
2. Use any of the following methods:
   * Drag the slur.
   * Adjust the horizontal and vertical offset values in the [Inspector](/3/basics/inspector.md#element).

To adjust *all* the properties of a slur (length, shape and position):

1. Make sure you are *not* in **note input mode**;
2. Go into [**Edit mode**](/3/basics/edit-mode.md) on the slur;
3. Click on a handle to select it, or use <kbd>Tab</kbd> to cycle through the handles;
4. To move the *left and right handles* from note to note, use the following shortcuts:
   * <kbd>Shift</kbd>+<kbd>Right</kbd>: Move to next note.
   * <kbd>Shift</kbd>+<kbd>Left</kbd>: Move to previous note.
   * <kbd>Shift</kbd>+<kbd>Up</kbd>: Move to lower voice (voice 2 to voice 1 etc.).
   * <kbd>Shift</kbd>+<kbd>Down</kbd>: Move to higher voice (voice 1 to voice 2 etc.).
5. To adjust the position of *any* handle, use any of the following methods:
   * Drag the handle.
   * Use the arrow keys for fine adjustment (0.1 [sp.](/3/appendix/glossary.md#spatium) at a time). For larger adjustments (1 [sp.](/3/appendix/glossary.md#spatium) at a time) use <kbd>Ctrl</kbd>+<kbd>→ ← ↑ ↓</kbd>.
6. Press <kbd>Esc</kbd> to exit **edit mode**.

**Note**: The two outer handles adjust the start and end of the slur, whilst the three handles on the curve adjust the contour. The middle handle on the straight line is used to move the whole slur up/down/left/right.

## Extended slurs

A slur can span several systems and pages. The start and end of a slur is anchored to a note/chord or rest. If the notes are repositioned due to changes in the layout, stretch or style, the slur also moves and adjusts in size.

This example shows a slur spanning from the bass to the treble clef. Using the mouse, select the first note of the slur, hold down <kbd>Ctrl</kbd> (Mac: <kbd>Cmd</kbd>) and select the last note for the slur, and press <kbd>S</kbd> to add the slur.

<figure><img src="/files/ulE5QvCFQxmziGrBL6QW" alt="Slur across staves"><figcaption></figcaption></figure>

<kbd>X</kbd> flips the direction of a selected slur.

## Dotted/dashed slurs

Dotted slurs are sometimes used in songs where the presence of a slur varies between stanzas. Dotted slurs are also used to indicate an editor's suggestion (as opposed to the composer's original markings). To change an existing slur into a dotted or dashed slur, select it and then in Inspector (<kbd>F8</kbd>) change `Line type` from `Continuous` to `Dotted` or `Dashed`.

## See also

* [Tie](/3/notation/ties.md)
* [Edit mode](/3/basics/edit-mode.md)
* [Note input](/3/basics/note-input.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://handbook.musescore.org/3/notation/slurs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
