Skip to content
Actions for Obsidian icon Home Actions for Obsidian 2024.2.1 › Actions

Actions for Obsidian › Actions › Rename/Move Note

Renames or moves a note.

This action will throw an error if the specified note doesn't exist, so it's best to use it after the "Check For Existence Of Note" action has determined that it does exist.

Parameters

Vault

The vault to work in.

Type: Vault reference

Note Lookup

Specify which note should be looked up or manipulated by the action:

  • "note": If you want to use another AFO action’s Note result, pick this option.
  • "note at file path": The full path of the note, should be used if you already know the full file path (including folder and file extension).
  • "note with UID": Use this if you are using unique identifiers for your notes, and you prefer to look them up by the UID.
  • the current Periodic Note (daily, weekly, etc.)

Options:

  • note
  • note at file path
  • note with UID
  • Daily Note
  • Weekly Note
  • Monthly Note
  • Quarterly Note
  • Yearly Note

Current File Path

The path of the note, relative to the vault root.

Only available when Note Lookup is set to "note at file path".

Type: Text

UID

The unique identifier of the note. To configure the frontmatter key that is used for the lookup, go into Obsidian's settings, section "Community plugins", and find Actions URI.

Only available when Note Lookup is set to "note with UID".

Type: Text

Obsidian Note

A Note that was returned by another AFO action.

Only available when Note Lookup is set to "note".

Type: Note reference

New File Path or Name

If the new file path contains a folder structure, that folder structure must exist, i.e. it won't be created automatically.

If the new file path is the same as the original one, nothing happens.

If the new file path already exists, an error is returned. If the new file path specifies a destination folder that does not exist, an error is returned.

Please note that to move the note to a new folder, you'll need to specify the full destination path, i.e. folder and file name.

Type: Text

Examples

Current file path Note, new file path Great Note:
Note Note.md is renamed to Great Note.md.

Current file path Note, new file path /Great/Note:

  • If the folder /Great/ exists: Note.md is moved from its place at the root level of the vault into the folder /Great/.
  • If the folder /Great/ does not exist: An error.