KeyValue icon

KeyValue

Store and retrieve key-value pairs on the filesystem

Actions20

Record → Read

AI-generated

Summary

Read a record from the selected directory on the local filesystem. Choose whether to return its parsed body, frontmatter, or both.

Inputs

  • Directory Name (required) — Directory containing the record.
  • Key (required) — Record key, used as the filename.
  • Mode — Controls returned fields: Body Only returns directory, key, and value; Frontmatter Only returns directory, key, and frontmatter; Full (the default) returns those fields plus body. The body is parsed as JSON when it contains a JSON object or array; otherwise it is returned as text.

Output shape

One n8n item per input item, with a single JSON record for each successful read.

The selected file must exist; a missing record raises an error. frontmatter is null when the file has no recognized frontmatter.

Links

Discussion