Where apps hide your files

Finding your Logseq graph folder

Updated 2026-10-28 · 6 min read

Logseq does not hide Markdown notes in a database: a graph is a folder you picked when you created it. The newer database edition uses a fixed folder instead, and a hidden ~/.logseq folder holds plugins and settings for both.

Where the files are

Logseq now ships as two editions, and they keep notes in different places. Logseq OG (the Markdown edition, version 0.10.x) stores each graph in a folder you choose. Logseq 2.0, the database edition that is still labelled beta, keeps its graphs in a fixed folder by default. Both use one hidden folder in your home directory for plugins and settings.

<the folder you picked>/     Markdown graph (Logseq OG): pages, journals, assets
~/logseq/graphs/             database graphs (Logseq 2.0), one subfolder per graph
~/.logseq/                   plugins, global config, cached graph data

A Markdown graph has no fixed path. Logseq asks you for a folder when you add a graph, so yours might be in Documents, in iCloud Drive, in Dropbox or anywhere else, and the documentation names no default.

The database edition is different. Logseq's source code sets its default graphs folder to ~/logseq/graphs (a visible folder called logseq in your home folder, no dot), with one subfolder per graph named after it. Those graphs are databases rather than Markdown files, so read and change them through the app, and use its export when you want your notes as files.

Finding a Markdown graph you have lost

Every Markdown graph contains logseq/config.edn, so search your home folder for that file. This read-only command lists matches and skips ~/Library:

find ~ -maxdepth 6 -path ~/Library -prune -o -path '*/logseq/config.edn' -print 2>/dev/null

Each hit sits in <graph>/logseq/config.edn, so the folder that contains the logseq folder is the graph. A graph in iCloud Drive lives under ~/Library/Mobile Documents, which that command skips, so check there separately:

find ~/Library/Mobile\ Documents -maxdepth 6 -path '*/logseq/config.edn' 2>/dev/null

macOS may ask whether Terminal can access Documents or Desktop; allow it, or the search quietly skips those folders. To open a result, press ⇧⌘G in Finder (Go > Go to Folder) and paste the path, or run open followed by the path.

Inside a Markdown graph

Folder	What it holds
pages/	One Markdown file per page.
journals/	One file per day, named yyyy_MM_dd by default, for example 2026_10_28.md.
assets/	Images, PDFs and other attachments you add.
logseq/	The graph's own settings: config.edn, custom.css and backup folders.

The folder names and the journal file format are the defaults in Logseq's config template, and config.edn can change all three, so an older or customised graph may differ.

To edit config.edn without hunting for it, open Logseq's settings and choose General > Custom configuration > Edit config.edn (the labels in Logseq's own English strings). The row only appears while a graph is open. Treat the file as private if you have pasted tokens into it.

Logseq also writes safety copies inside logseq/. Its source code saves timestamped backups to logseq/bak/ and to logseq/version-files/, keeping the six most recent per file, for example when a page changes on disk in a way that clashes with the copy Logseq has open. They are useful for recovering a page, but they are not a backup of the graph.

What ~/.logseq holds

The leading dot hides this folder in Finder. Open it with ⇧⌘G and ~/.logseq, or from Terminal:

open ~/.logseq

Logseq's source code and its forum describe these parts:

• config/config.edn: the global configuration shared by all graphs. Settings shows an Edit global config.edn button for it when global config is enabled.
• config/plugins.edn: the list of plugins to install.
• plugins/: the installed plugins themselves.
• settings/: one JSON file of settings per plugin.
• graphs/: .transit cache files, one per Markdown graph, that speed up loading. They are rebuilt from your files.
• preferences.json: plugin and theme preferences.

The cache is not your notes, so never treat it as a backup. If a graph looks stale or broken, use Re-index in Logseq rather than editing these files.

The app itself also keeps a small folder at ~/Library/Application Support/Logseq, Electron's standard location, where Logseq's source code stores an app-level configs.edn (proxy and other app settings) beside the usual browser caches. Your notes are never there.

Logseq is not installed on the Mac used for this guide, so none of these folders was checked locally. The paths come from Logseq's source code on GitHub and may shift between versions, so list the folders yourself before relying on a name.

Moving a graph or setting up a new Mac

A Markdown graph is a plain folder, so moving it is a Finder job. Quit Logseq, move the whole folder, then open it again from Logseq's graph menu and point it at the new place. Logseq re-indexes it.

For a new Mac, copy the graph folder across with its logseq/ subfolder, which carries config.edn and custom.css, then install Logseq and open the folder. Copy ~/.logseq too if you want your plugins and global settings. For a database graph, use the app's own export or backup rather than copying the database while Logseq is running.

Keep a graph that is synced through iCloud Drive or Dropbox open on one Mac at a time, and let the sync finish before you switch. Two machines writing the same page at once is how conflict copies appear.

Why search misses these files

Spotlight and Finder searches show your page files when the graph is in Documents or iCloud Drive, but they leave out anything inside a folder whose name starts with a dot, so ~/.logseq and its plugins and config never show up. The Electron folder in ~/Library/Application Support is left out too.

Finding the files again later

Searching by file name works well here, because Logseq names files after what you see. Typing config.edn in Everywhere lists the config file of every Markdown graph plus the global one, which shows at a glance where each graph lives, and typing a page title or a date such as 2026_10_28 finds that page or journal. ~/.logseq is indexed from the start, while graphs in Documents, Desktop or iCloud Drive appear once you grant it Full Disk Access. It matches names only, not the text of your notes.

Common questions

Where does Logseq store my notes on a Mac?

Logseq OG, the Markdown edition, stores each graph in the folder you chose when you created it, with pages, journals, assets and logseq folders inside. The Logseq 2.0 database edition keeps graphs in ~/logseq/graphs by default.

Where is the Logseq config.edn file?

Each Markdown graph has its own in <graph>/logseq/config.edn, which you can open from Settings > General > Edit config.edn. The global one is ~/.logseq/config/config.edn.

What is the ~/.logseq folder?

A hidden folder in your home directory that holds plugins, plugin settings, the global config and cached graph data. Your notes are not stored there, and the cache is rebuilt from your graph folders.

How do I find a Logseq graph I have lost?

Search for a file named config.edn inside a folder called logseq; the folder above that is the graph. The find commands in this article do it read-only, including iCloud Drive.