Advanced Search

NotePlan allows you to search for notes or for a specific line (like a task, a bullet, etc.) inside a note:

  • Search for a note by title: Command Bar (CMD+J) or tap on the magnifier glass icon on iOS
  • Search and filter notes: Folder Views. Click on any folder or on "Notes" in the sidebar, then configure a filter to find specific notes.
  • Search for note content: Open "Search" in the left sidebar or CMD+Shift+F to find tasks, bullets, or any lines inside your notes.

➡️ View the full video here.

Advanced Search Syntax

The content search (open "Search" or "Filters" in the sidebar), and the Folder View search supports the following syntax.

Note: Boolean OR and grouping is supported from v3.18.1

  • Exact matches (whole words): surround a word with quotes. Example: "sun" returns lines where sun appears as a word, not as part of sunlight. From v3.22 this also works for terms that start with @ or #, e.g. "@done(2026-10-11" or "#release".
  • Exclusions: prepend a hyphen to exclude. Example: #pending -#waiting returns results with #pending that do not also contain #waiting.
  • Implicit AND: a space means AND. Example: project report returns lines that contain both project and report.
  • Boolean OR: use OR (uppercase) to match either side. Examples:
    • meeting OR meetup — matches if either word is present.
    • #work OR #personal — matches notes/lines containing either tag.
  • Grouping with parentheses: use parentheses to control precedence and combine expressions.
    • meeting (work OR meetup) — must include "meeting" and either "work" or "meetup".
    • (urgent OR high) #todo — includes either "urgent" or "high" and the #todo tag.
    • (#work OR #personal) (review OR recap) — at least one tag group and one keyword group must match.
  • Grouped negation:
    • meeting -(work meetup) — includes "meeting" but excludes lines that contain both "work" and "meetup" together.
    • (draft OR proposal) -#archived — includes either "draft" or "proposal" but excludes the #archived tag.
  • Quoted phrases inside groups:
    • ("design review" OR "code review") #todo — matches either phrase plus #todo.
  • Nesting: you can nest groups for complex logic.
    • (projectA (design OR testing)) OR (projectB (spec OR "kick off"))

Tips:

  • Combine spaces (AND), OR, - (NOT), and parentheses to craft precise queries.
  • Use uppercase OR for clarity when combining alternatives (as shown in examples).
  • OR and parentheses work between search words, not between operators. To search several folders, statuses or sources, use a comma list inside one operator (see below).

On Mac you can additionally decide what sources NotePlan should search: Calendar Notes, Events, Reminders or only Regular Notes (disable everything). You can find a settings drop down right of the search field on Mac to configure this.

Search Operators

Use search operators at the beginning of your search to quickly filter results. Format: operator:value ... search text

Note: Supported from v3.18.1

  • Source operators:
    • source:calendar - Calendar notes only
    • source:notes - Regular notes only
    • source:events - Events only
    • source:reminders - Dated reminders grouped by date
    • source:list-reminders - All reminders grouped by list (dated and undated)
    • source:dated-notes - Dated notes only
    • source:notes,events - Multiple sources (comma-separated)
  • Task status operators:
    • is:open - Open tasks
    • is:done - Completed tasks
    • is:scheduled - Scheduled tasks
    • is:canceled or is:cancelled - Canceled tasks
    • is:not-task - Lines that are not tasks (this returns only results if you also supply a search query)
    • is:open,done - Multiple statuses (comma-separated)
  • Checklist status operators:
    • is:checklist - Open checklist items
    • is:checklist-done - Completed checklist items
    • is:checklist-scheduled - Scheduled checklist items
    • is:checklist-cancelled - Cancelled checklist items
  • Date operators: date: looks at the date of a calendar note and at scheduled dates (>2025-08-25) of tasks.
    • date:today - Today's items
    • date:yesterday - Yesterday's items
    • date:tomorrow - Tomorrow's items
    • date:past - Past items
    • date:future - Future items
    • date:past-and-today - Past items including today
    • date:overdue - Open tasks scheduled before today
    • date:this-week - This week
    • date:last-week - Last week
    • date:next-week - Next week
    • date:this-month - This month
    • date:last-month - Last month
    • date:next-month - Next month
    • date:this-year - This year
    • date:last-year - Last year
    • date:next-year - Next year
    • date:30days - Rolling 30 days
    • date:all - All time (default if nothing is defined)
    • Custom ISO dates:
      • date:2025-08-25 - Specific day (YYYY-MM-DD)
      • date:2025-W35 - Specific week (YYYY-WNN)
      • date:2025-08 - Specific month (YYYY-MM)
      • date:2025-Q3 - Specific quarter (YYYY-QN)
      • date:2025 - Specific year (YYYY)
    • Date ranges: write the start and the end with .. between them. Each end can be a day, week, month, quarter or year: a period starts on its first day and ends on its last day.
      • date:2025-08-01..2025-08-30 - Day range
      • date:2025-W01..2025-W52 - Week range
      • date:2025-06..2025-07 - Month range
      • date:2025-Q1..2025-Q4 - Quarter range
      • date:2024..2025 - Year range
      • The older form with a hyphen (date:2025-08-01-2025-08-30) still works for ranges of the same type.
    • Open ranges (from v3.22): leave out one end.
      • date:2025-09-01.. - From September 1, 2025 on
      • date:..2025-09-30 - Up to September 30, 2025
      • date:2025-Q3.. - From the start of Q3 2025 on
    • Relative ranges (from v3.22): a number of days (d), weeks (w), months (m) or years (y) from today. The range includes today.
      • date:-7d - The last 7 days
      • date:+2w - The next 2 weeks
      • date:-3m - The last 3 months
      • date:-30d..today - From 30 days ago until today (as an end of a range, an offset is one day)
      • date:today..+14d - From today until 14 days from now
    • Examples:
      • date:2025-08-25 meeting - Meetings on August 25, 2025
      • date:2025-W35 review - Reviews in week 35 of 2025
      • date:2025-08-01..2025-08-30 vacation - Vacation items for August 2025
      • is:open date:..2025-12-31 project - Open project tasks scheduled up to the end of 2025
      • source:calendar date:-14d is:open meeting - Open meeting tasks in the calendar notes of the last 14 days
  • Completion date operator (from v3.22): done: finds completed tasks and checklist items by the date in their @done(...) stamp, not by the note or scheduled date. It takes the same values as date:.
    • done:today - Completed today
    • done:this-week - Completed this week
    • done:30days - Completed in the last 30 days (for done:, 30days looks back)
    • done:-7d - Completed in the last 7 days
    • done:2025-10 - Completed in October 2025
    • done:2025-09-01.. - Completed since September 1, 2025
    • done:last-month path:"10 - Projects/ClientX" - Completed last month in one project folder
    • Only lines with an @done(...) stamp can match. NotePlan adds the stamp when you complete a task and the completion date setting is on (Settings > Todo, "Append completion date").
  • Location operators:
    • path:Projects/Work - Search in specific folder path
      • path:"10 - Projects/Marketing" - Use quotes for folders with spaces
      • path:"10 - Projects/Marketing","10 - Projects/Review" - Search in several folders (comma-separated, from v3.22). A line matches if its note is in any of them.
      • A comma inside quotes belongs to the folder name: path:"Ideas, Drafts" is one folder.
      • You don't need to include "Notes" into the path.
      • Paths are case-sensitive.
      • Subfolders are included.
    • heading:TODO - Search under specific heading
      • heading:"Project Goals" - Use quotes for headings with spaces
  • Sort operators:
    • sort:asc - Sort results by date from oldest to newest (past → future)
    • sort:desc - Sort results by date from newest to oldest (future → past)
  • View options:
    • show:timeblocked - Show timeblocked events
    • hide:past-events - Hide past events
    • hide:archive - Hide results from archived notes (available from v3.18.2)
    • hide:teamspaces - Hide results from teamspace (calendar) notes (available from v3.18.2)
  • Combined operators:
    • source:calendar is:open date:this-week meeting - Combine multiple filters
    • heading:"Weekly Review" is:open tasks - Find open tasks under a specific heading with spaces
    • Search operators can be combined with advanced syntax: source:notes is:open (urgent OR high) -#archived

Notes:

  • Search operators require spaces to separate multiple operators.
  • Do not use spaces after colons (e.g., use source:calendar not source: calendar).
  • For values with spaces (like heading names), wrap them in quotes: heading:"My Project Name". Straight and typographic (“smart”) quotes both work from v3.22.
  • In a comma list, a space after the comma is allowed before a quoted value or a status/source (is:open, done). Any other word after the space is a search word again: is:open, meeting means open tasks with "meeting".
  • You can escape operators with a backslash if you want to search for them literally, e.g. \date:this-month