Skip to content

Project Settings

Jump to bottom
Björn Platte edited this page Feb 9, 2026 · 2 revisions

Project Settings

GitHub Projects (v2) integration allows you to track project boards and view them as Kanban boards in Obsidian.

Adding Projects

Load Projects

  1. Go to GitHub Projects section in settings
  2. Click Load Projects
  3. Browse the Available Projects tab
  4. Select projects to track
  5. Click Add Selected Projects

Projects are loaded from your tracked repositories and organizations.

Project Configuration

Each tracked project has its own settings:

Issues Storage

Folder Template

Folder path for issue files. Supports variables:

Variable Description Example
{project} Project title My Project
{owner} Project owner LonoxX
{project_number} Project number 1

Example: GitHub/{project} → GitHub/My Project/

Use Custom Folder

Bypass template processing and use a direct folder path.

Filename Template

Template for issue filenames. See Filename-Templates.

Content Template

Custom markdown template. See Content-Templates.

Include Sub-Issues

Include GitHub sub-issues in generated files.

Pull Requests Storage

Same options as Issues:

  • Folder Template
  • Use Custom Folder
  • Filename Template
  • Content Template

Kanban View

Open the Kanban view with the command: Open GitHub Projects Kanban

Features

  • Visual board organized by status columns
  • Tab navigation between projects
  • Click cards to open the note

Customize Columns

Status Columns

Manage your project's status columns:

  • Drag to reorder columns
  • Toggle visibility (eye icon) to show/hide columns
  • Refresh from GitHub to reload status options

Show Empty Columns

Display columns even when they have no items.

Skip Hidden Statuses on Sync

Don't download issues/PRs that have a hidden status. This saves API calls and keeps your vault clean.

Project Template Variables

When using content templates with projects, additional variables are available:

Variable Description
{project} Project title
{project_url} Project URL
{project_number} Project number
{project_status} Item's status in project
{project_priority} Priority field value
{project_iteration} Iteration/sprint name
{project_iteration_start} Iteration start date
{project_iteration_duration} Iteration duration (days)
{projects} All projects (comma-separated)
{project_fields} Custom fields as YAML
{project_field:FieldName} Access specific custom field

See Template-Variables#GitHub Projects for complete reference.

Conditional Project Content

Use conditional blocks to show content only when in a project:

{project:## Project Info
- **Project:** [{project}]({project_url})
- **Status:** {project_status}
{project_priority:- **Priority:** {project_priority}}
{project_iteration:- **Iteration:** {project_iteration}}
}

See Example-Templates#Project Template for a complete example.

Profile

Each project is assigned a profile that provides its default settings (folders, templates, sync behavior). You can change the profile in the project settings dropdown.

See Settings-Profiles for how to create and manage profiles.

Clone this wiki locally