# Renaming notes

Renaming a note through `settle` comes with the benefit that all links to the former title are updated, which means that links (almost) never break.

You can rename a note by using the `settle sync --rename <FROM> <TO>`. Titles here are matched exactly, as using regex could match multiple notes.

Here are two examples:

- `settle sync --rename "PSYCHOLOGY" "Psychology"` renames "PSYCHOLOGY" to "Psychology"
- `settle sync --rename "Neuroology" "Neurology"` renames the note called "Neuroology" to "Neurology"

### Errors

- if the specified old title doesn't exist, then an error is returned
- if there is already a note with the new title provided, then an error is returned and the overwrite is prevented.