Filer

What's changed in Filer plugin?

Please see the Readme for this plugin for more details, including the available settings.

[1.6.3] - 2026-11-02

• now /move paragraph... and /move block commands move any embedded image/media files as well. dev: an embedded image or file (![image](...) / ![file](...)) is copied into the destination note's attachment folder and the link is updated. Previously the file stayed next to the source note, so the image broke after the move. If the source note is a regular note and nothing left in it still links the file, the original is moved to the trash.

[1.6.2] - 2026-10-26

• fix /move paragraph... (and calendar move variants): when "Add date reference?" is on, the source line is deleted again. Previously mutating the paragraph before removeParagraphs caused NotePlan to remove 0 lines, leaving a duplicate in the calendar note.
• fix /move completed items to done section creating a new heading if the existing sub-heading was folded (e.g. ### Section …), and when the source section heading was folded.
• fix /move note links (and recent variant): stripping the [[note link]] could fail after the copy. Also resolves folded destination headings and skips delete if the insert failed.

[1.6.1] - 2026-06-26

• fixes and improvements to /move completed items to done section:
  • recreated/moved section headings are now nested one level deeper inside the Done section (e.g. an active ## Section becomes ### Section under ## Done), so they sit inside Done rather than as a sibling of it. This also lets completed items correctly merge into matching existing sub-headings in the Done section.
  • no longer introduces stray blank lines when merging a completed section into an existing Done sub-section.
  • in "move when any are complete" mode: when a whole section ends up being moved, its now-empty section heading is removed from the active part, and completed items correctly re-use an existing matching sub-heading in the Done section (previously a new, wrongly-deeper heading could be created).
  • no longer creates a duplicate ## Done heading if the existing one was folded.
  • when a whole section has been completed, remove its heading as well as the tasks lines, from the active section.
  • if a section has no task/checklist paragraphs at all, then don't move it to the archive.
  • moved tasks, bullets and quotes no longer get duplicated markers (e.g. * [x] * [x] , - - , > > ) when written to the Done/Completed section.

[1.6.0] - 2026-05-01

• new /unarchive note keeping folder structure command that reverses /archive note keeping folder structure by moving a note from @Archive back to its original folder path.

[1.5.3] - 2025-03-16

• fix: improvements to the /move completed items to done section command
• dev: added tests for its helper functions
• change: for the /move completed items to done section command, replaced the boolean setting "Only move completed items when whole section is complete?" with a new string setting "When to move completed items to Done". This offers three options: ask each time (default), move when whole section complete, and move when any are complete.

[1.5.2] - 2025-02-18

• Improvements to the /move completed items to done section command:
  • allow customising the "Done" section heading name. This defaults to Done but can be set to something else (for example Completed). (for @jose)
  • add option to skip done subtasks that are indented under open parent tasks, so that these subtasks remain visually grouped with their parent until the parent is complete. (for @jose)
  • if there are no lines/blocks to move, then a message is shown to the user, confirming what settings it has used.
• Reorganised the plugin's settings screen.

[1.5.1] - 2025-02-18

• fix "Add date reference?" option so that when moving from a non-today daily (calendar) note the added date now correctly points to the source note's date, not always to today. (Thanks for the report, @vlow)
• added link as an option for the "Date reference style" setting.

[1.5.0] - 2025-12-26

• new /move completed items to done section command that extends NP's built-in 'Move Completed to Bottom' menu action. This is a more powerful version of NotePlan's built-in 'Move Completed to Bottom' menu action. It has two settings, which reveal its additional powers:
• Recreate existing section structure in Done section? (default: true)
• Only move completed items when whole section is complete? (default: false)

[1.4.1] - 2025-12-15

• fix /move paragraph... commands when moving to a heading with trailing spaces (thanks, @stacey)

[1.4.0] - 2025-11-25

New

• /add sync'd copy to note now can work on a block of lines. They will go to consecutive lines in the same destination note and section.

Fixed

• trying a different way to fix recent NP API change when using "/move..." and "/add sync..." commands on notes with frontmatter. (Addresses #704)
• "/quick move to today's note" not honouring "Where to add in the note" setting as 'start' (thanks, @anom)

[1.3.3] - 2025-11-07

• fix duplication in /move block (thanks for the tip, @bido_1977)
• improved the heading picker used in some of these commands

[1.3.2] - 2025-09-06

• suppress notes in the special Archive and Template folders from the note chooser in /add sync'd copy to note and /move ... commands (for @chrismetcalf)
• fix for /archive note keeping folder structure command
• fix for /add sync'd copy to note command

[1.3.1] - 2025-08-23

• further fix when trying to work around NP bug when using /move paragraph block on notes with frontmatter.

[1.3.0] - 2025-08-15

Added

• can now access notes from Teamspaces
• improved display of note picker (when running NP 3.18+)
• note picker now includes '+ new note' option for /move paragraphs (for @oldielajolla)
• improved display of heading picker (when running NP 3.18+)

Fixed

• worked around NP bug when using /move paragraph block on notes with frontmatter. (Thanks for report by @Bono2007.)

[1.2.0] - 2025-01-07

• the /add sync'd copy to note command will now work on multiple lines -- and there's a new setting that allows you to set a default heading to sync all lines under. (for @chrismetcalf, closes #610). And fixed regression with it.
• New /quick move ... commands for monthly and quarterly notes, not just daily and weekly notes.

[1.1.6] - 2024-12-31

• the new note from clipboard and new note from selection commands have moved to the NoteHelpers plugin.
• workaround for move ... commands not working properly, which stem from trailing whitespace on Headings in the destination notes. (Thanks to @trmax + @magicnemo for help diagnosing the problem and suggesting a workaround.)

[1.1.5] - 2023-10-20

Changed

• hopefully a fix for "/move paras" sometimes not removing the lines from the original note

[1.1.4] - 2023-09-01

Changed

• hopefully a fix for "/add sync'd copy to note" sometimes failing to add the sync in one of the two notes, because of a race condition. Please give feedback if you still find this happens.

[1.1.3] - 2023-08-29

• fix bug that prevented moving/filing items to a note in the root folder

[1.1.2] - 2023-08-15

Changed

• improved the Heading selector to allow to add at the top of the note (under the title but before the first heading)
• under-the-hood changes to use newer library versions

[1.1.1] - 2023-06-10

Added

• now /new note from clipboard and /new note from selection commands offer option to create a new folder when selecting a folder (suggested by @dwertheimer)

[1.1.0-beta5] - 2023-04-18

Added

• new /archive note keeping folder structure command (suggested by @antony-sklyar)

[1.1.0-beta4] - 2023-04-10

Added

• can now run the copy/move recent notelink commands via x-callback or as template functions

Changed

• turned off feedback dialogs for each note, instead having a single feedback dialog at the end

[1.1.0-beta3] - 2023-04-09

Added

• command to edit settings, even on iOS
• setting "Allow preamble before first heading?" If set, some 'preamble' lines are allowed directly after the title. When filing/moving/inserting items with these commands, this preamble will be left in place, up to and including the first blank line, heading or separator. Otherwise the first heading will be directly after the note's title line (or frontmatter if used).

[1.1.0-beta2] - 2023-03-19

Added

• new setting "Types of lines to file" for the /...note link... commands to choose what sorts of lines to move/copy:
  • all lines
  • all but incomplete task/checklist items
  • only completed task/checklist items
  • only non-task/checklist items
• new setting "Where to add in the note" for the /...note link... commands. If the [[note link]] doesn't include a heading, then this controls whether filed lines get inserted at the start or end of the note.

[1.1.0-beta1] - 2023-03-19

Added

• 4 new related commands that move or copy lines in calendar notes that include a [[note link]] to the project note with that title:
  • /move note links
  • /move note links (recently changed)
  • /copy note links
  • /copy note links (recently changed)
• There are a number of settings to make it useful for a variety of ways of organising your notes -- please see the README.
• new /filer:update plugin settings command, that allows settings to be changed on iOS/iPadOS (thanks to @dwertheimer for this feature).

[1.0.0-beta3] - 2022-11-28

Changed

• polished the heading picker, particularly for Calendar notes

[1.0.0-beta2] - 2022-10-28

Fixed

• fix where trailing spaces on headings could cause data loss when using /move commands

[1.0.0-beta1] - 2022-08-18

Changed

• existing command /move paragraphs renamed to /move paragraph or selection. This moves this paragraph (or selected paragraphs) to a different note
• added command /move paragraph block moves all paragraphs in the current block to a different note. Use the settings to determine how far before and after the current paragraph the block will extend.
• retired the command alias /file paragraphs, as /move paragraphs is clearer