Docs / Settings

Settings

What each setting does and where it's kept.

Open Settings from the gear at the bottom of the sidebar, the menu under your name, ⌘K, or the right-click menu. It's one page of sections, with a list beside it to jump between them (a dropdown on phones). Changes save as you make them, and each section says where it's kept.

Project settings are a separate page. See Project settings and tags.

The sectionsLink to this section

Kept in YouTrackLink to this section

These are your YouTrack profile settings, so they follow you to every device and to YouTrack itself.

• Time zone. Comment times use it.
• First day of the week: Monday, Sunday or Saturday. The date picker uses it.
• Email notifications, including whether to email you when someone mentions you, and whether to email you about your own changes.
• Auto-watch: whether you start watching issues you create, comment on, change or vote for.

The date format is shown with a link to your YouTrack profile, where you change it.

Synced: Suru Me's own settingsLink to this section

These belong to Suru Me. They're saved in your browser and synced to your other devices through a private note in your YouTrack that only you can see.

They sync when the app opens, when you come back to it, and a second after you change one.

• Theme: System, Light or Dark
• Row density: Comfortable or Compact
• Show progress as tasks (1 of 3) or percent (33%). See Progress.
• Show issue IDs in lists
• Epics shown per area in the sidebar: 3, 5, 10 or all
• Open-task counts in the sidebar. Turning them off also saves the requests they make.
• Epic progress bars in the sidebar
• List defaults: view, grouping, sort, whether closed tasks show, and whether subtasks show under their tasks or stay folded
• Issue panel width: Normal, Wide or Full screen
• Comment order: Newest first, the default, or Oldest first
• Start page: Home, My day, or The last page I was on. It applies when a new tab opens the app on Home.

Folded sidebar sections and the sidebar's width sync too. The last page you visited stays with each browser.

ResetLink to this section

Reset puts every synced setting back to its default on all your devices, along with the theme, folded sidebar sections and the sidebar width. You stay signed in, your YouTrack profile settings stay as they are, and your issues don't change.

It only touches settings. Your captured lines, pinned views, pinned epics and your sidebar order, epic colours, what you've marked done in the Inbox, when you last cleared Home and a running timer all stay as they are.

Also hereLink to this section

The Default states section holds the states new projects get; admins can change it (see Default states). The Suru Agents section connects Suru Agents, which then writes its agents in by itself (see Connecting Suru Agents). The Agents section is where admins set up the names you can mention to send a comment to a webhook (see Agents). The AI assistants section sets up assistants like Claude (see AI assistants), and Keyboard shortcuts lists the keys (see Keyboard shortcuts).