Skip to main content

Get started - user interface areas

TagSpaces opens up as a single-window application that tries to make the best use of any space available, be it large wide screens, or small mobile displays. The user interface, devised along the guidelines of Google's material design specifications, is very adaptable. The application will look the same, regardless of the operating system, or platform it runs under.

This streamlined experience offers familiarity and an ease to use the application across platforms, while you will need to familiarize yourself with its extensive features only once. The following screen shows a typical start screen of TagSpaces with the list of the available locations on left, and content of the currently opened folder with the default perspective in center of the application.

explanation of the applications user interface areas

The user interface of the application consists of the following main areas:

  • (1) Left Drawer - Here you can open the location manager or the tag library and access other important functionalities of the app like the settings.
  • (2) Navigation and Search - Here you can open the search, switch the current location or navigate to a parent folders.
  • (3) Browsing area - This section is occupied by the so called perspective used for browsing files and folders.
  • (4) Common actions area - Here you can access common actions for the currently opened file or folder.
  • (5) File / Folder properties - Here you will find the properties of the currently opened file or folder.
  • (6) File Preview - In this area you can preview and/or edit the current file.

Left Drawer

The main drawer of the app is divided in three sub areas.

The one located at the top shows the logo of the app and its current version. Clicking on the app logo will open the About dialog of the app, where you can find details about the licensing or check for new app versions. Right beneath the logo you find a bar containing two buttons. The first one called Create will open a dialog where you can create files in TagSpaces. The second button "New Window" will open a new TagSpaces window or tab.

The area at button contains six buttons. The button with the gear icon (1) located at the left will open the app settings. With the button (6) at the most right you can switch between the light and dark themes of the app. If you are using the TagSpaces Enterprise product this button will be exchanged with a button, which will open the properties of the currently logged user.

drawer toolbar

The with the four so called radio buttons in the middle, you can switch between the following areas in main part of the drawer:

  • (2) Location Manager - this is the place for managing your locations
  • (3) Tag Library - the library contains all your tags organized in tag groups
  • (4) Quick Access - here you will find stored searches, bookmarks and lists of recently used files and folders.
  • (5) Help & feedback - here you can access the application help, suggest a feature or contact us.

The file browsing area normally takes up he majority of the user interface. This is where all files from the currently active folder are displayed, either as a list, grid, or kanban board, depending on the active perspective. To learn more about the all file browsing features, navigate to the perspective section.

Screenshot showing the file browsing area

  • (1) - Toggles the left drawer.
  • (2) - Navigates back to the last opened file, folder or location, this feature is still in beta status.
  • (3) - Reverts the navigation step of the back button.
  • (4) - Opens the search mode.
  • (5) - Shows the all the parent folders as button up the location root folder. A click on a folder button, will navigate to it.
  • (6) - Shows the name of the current folder, clicking on it will open the folder menu.
  • (7) - Here you can switch perspective of the current folder

If you are in a cloud based location, the icon of the button of the folder in (5) will be a cloud, in other cases the icon will be a briefcase.

Folder menu

The menu for the current folder contains the following items:

  • Reload Folder - Reloads the content of the current folder
  • Rename Folder - Opens a dialog where you can rename the current folder
  • Delete Folder - Opens a dialog where you can confirm the deletion of the folder
  • Show in File Manager - Opens the folder in the default file manager of the operating system
  • New File - Opens the dialog for creating new files or notes
  • New Subfolder - Opens the folder create dialog, where you can create a new subfolder
  • Add Files - Opens a file chooser where you can select a file from your local files system, which will be added to your current folder in TagSpaces.
  • Import macOS tags - This option is visible only on the native macOS app, selecting it will to extract native macOS tags and them as TagSpaces tags.
  • Grid Perspective - will present the current folder in the Grid perspective
  • List Perspective - will present the current folder in the List perspective
  • Gallery Perspective - will present the current folder in the Gallery perspective
  • Mapique Perspective - will present the current folder in the Mapique perspective
  • Kanban Perspective - will present the current folder in the Kanban perspective
  • Folder Properties - Opens the properties of the current folder

Preview Area

When a file is opened, the main UI area splits into two, the rightmost page becoming the Preview area. TagSpaces is capable of natively displaying different file types, from markdown, through HTML and docx, to PDF or various image files. To learn more about all the viewable and editable files, and TagSpaces' full file handling capacity, navigate to the Previewing Files and Editing Files sections respectively.

The following screenshot show a markdown file with the title diagrams (1). The file is not bookmarked and has one tag. The preview area can be closed by clicking the button with X icon located in section (2).

Area for previewing and editing files

A short explanation of the areas visible in the previous screenshot will follow:

  • (1) Title area - here you will find the title and the extension of the currently opened file or folder. You can also bookmark it and see if it has been tagged.
  • (2) Edit & Close - here you can close the currently opened file or folder. TagSpaces supports editing of some text file types and here you can start the edit mode and toggle the auto-save functionality.
  • (3) File / Folder Toolbar - containing buttons for common action for the currently opened file or folder
  • (4) Navigation - these buttons are shown only on files and will navigate to the next or the previous file in the current folder or search results
  • (5) Preview & edit area - this is the place where you can see the preview of currently opened file. Here you can also edit some of the supported text file types.

Dark Mode and Themes

The themes can be changed from the tab general of the settings.

Picture showing the app in the light and the dark theme

Multiple Windows and Tabs

You can use TagSpaces in more than one window or tab in the web versions. You can a location, a folder and a file in a new window/tab or you can simple open a further new instance of the application. The following screenshot shows some of the places where you can open a new window.

Ways to open new window or tab


All the instances share the same local storage. So if you are making changes to the application's settings, the last window which saves settings, locations, tags to the local storage will win.

Scalable User Interface

The user interface of the application scalable, this allows you to adjust the zooming factor according to your preference, screen resolution or display size. In the desktop you can access the zoom functionality from the View in the Main Menu. Here you will find zoom in, zoom out functionality and also the possibility to restore the initial zoom factor with Actual size menu item.

In the following screenshot you will see the menu options from the View sub menu and also TagSpaces with zoomed in interface.

Zoom menu items

And here you will see TagSpaces with zoomed out interface.

Zoomed out interface


If the application is running in a browser, please use the integrated in the browser zooming capabilities.

Full screen mode

The desktop application can run in a full screen mode, which can be toggled by pressing the F11 key, or selecting View -> Toggle Fullscreen from the Main Menu.

Toggling the fullscreen mode


If the application is running in a browser, the integrated full screen capabilities of the browser can be used.

Tray Menu

On Windows, macOS and Linux starting the desktop application will load also a so called tray menu, which is integrated in the operating system.

Tray menu on Linux

This menu offers the following functionalities:

  • Show TagSpaces Ctrl+Shift+W / Cmd+Shift+W - Brings the app on top if it is minimized or behind other windows.
  • Show Search Ctrl+Shift+F / Cmd+Shift+F - Brings the app on top and shows the search input field and brings the cursor on it, so you can enter your search query and confirm it with Enter.
  • New File / Note Ctrl+Shift+N / Cmd+Shift+N - Brings the app on top and shows the dialog for creating new files.
  • Open next file Ctrl+Shift+W / Cmd+Shift+W - Opens the next file (start its playback if audio/video file) in the current perspective or search results.
  • Open previous file Ctrl+Shift+W / Cmd+Shift+W - Opens the previous file (start its playback if audio/video file) in the current perspective or search results.
  • Pause / Resume Playback Ctrl+Shift+P / Cmd+Shift+P - Pause the currently played audio or video file, resumes the playback if it was paused.
  • Quit TagSpaces - Quits the app.

The key combination described here are globally available, so you can use them even if the application is not visible or on focus. The global keys can be disabled in the settings