Sources

A dataview "source" is something that identifies a set of files, tasks, or other data object. Sources are indexed internally by Dataview, so they are fast to query. Dataview currently supports four source types:

1. Tags: Sources of the form #tag. These match all files / sections / tasks with the given tag.
2. Folders: Sources of the form "folder". These match all files / sections / tasks contained in the given folder.
3. Specific Files: You can select from a specific file by specifying it's full path: "folder/File".
   • If you have both a file and a folder with the exact same path, Dataview will prefer the folder. You can force it to read from the file by specifying an extension: folder/File.md.
4. Links: You can either select links to a file, or all links from a file.
   • To obtain all pages which link to [[note]], use [[note]].
   • To obtain all pages which link from [[note]] (i.e., all the links in that file), use outgoing([[note]]).
   • You can implicitly reference the current file via [[#]] or [[]].

You can compose these filters in order to get more advanced sources using and and or.

• For example, #tag and "folder" will return all pages in folder and with #tag.
• Querying from #food and !#fastfood will only return pages that contain #food but does not contain #fastfood.
• [[Food]] or [[Exercise]] will give any pages which link to [[Food]] OR [[Exercise]].

If you have complex queries where grouping or predecence matters, you can use parenthesis to logically group them:

• #tag and ("folder" or #other-tag)
• (#tag1 or #tag2) and (#tag3 or #tag4)

Sources are used in both the FROM query statement, as well as various JavaScript API query calls.