How to query JSON files in Obsidian

Use JMESPath to select fields or filter records in a JSON file. As of October 2026, Obsidian code blocks display code; Local JSON Queries evaluates expressions against vault files.

Background

Start with the input structure before writing a filter. A rows array needs a different expression from JSONL records that become an array at the root.

2 ways to do it

  1. Learn expressions in the JMESPath tutorial

    Use the official tutorial’s interactive examples to practice field selection, projections and filters with its sample JSON. For a rows array, rows[*].name selects names.

    limits
    The tutorial is a browser exercise rather than a vault file picker. Keep private exports out of an online example.
  2. Local JSON Queries from this site

    Put the JSON or JSONL file in your vault, enter its path and run @ to inspect its shape. For JSONL records with a name field, try [*].name.

    For an object with a rows array, use rows[*].name, then save the file and expression as a named pair. Copy JSON keeps the complete result.

    limits
    This version accepts JMESPath only, with a 5 MiB input limit. Display caps do not shorten copied or reported results.
    The Adults named query restores its expression and shows two matching people in the result table.
    Open larger

    MIT · no telemetry · core features free

    All features of Local JSON Queries

Review the result with Local JSON Queries

  1. Put a JSON or JSONL file in your vault.

  2. Run Open JSON query view from the command palette.

  3. Enter the file path and a JMESPath expression, then select Run query.

  4. Save the pair with a name or select Copy JSON to copy the result.

Common questions

Which expression should I try before filtering?

Use @ to show the input value. Check its field names and array structure before writing a projection.

What does a null result tell me?

A missing field can return null without a parse error. Check the path, field case and input structure before changing the query.

Sources

Photo of Michael LipYou can now query JSON files in Obsidian.

Obsidian rewards people who share. NoteMods is just me and a lot of coffee. If this guide saved you a fight with the syntax, buy me a cup.