YouTrack Standalone 2017.1 Help

Global Settings

This page describes the global settings for YouTrack. These settings are available in the Server Settings section of the Administration menu.


The first section of the Global Settings page provides detailed information about the current subscription plan and a link to access your JetBrains Account.

You have the option to Show warnings to admin on exceeded license restrictions. If enabled, a warning message is sent to the administrator when the limitations of the license are exceeded.

Update Info

YouTrack automatically checks for available updates each time you open the Administration > Global Settings page. When a new version of YouTrack is released, a link to download the new distribution appears in the Update Info section.


The System section provides options that let you let you configure the basic system settings of your YouTrack server.

Base URLThe URL by which the YouTrack server is accessible to the end-users.  This URL is generally used for constructing links in notifications, reports, RSS feeds, and for the bookmarklet. You can either enter the server URL yourself, or click the Guess URL link let YouTrack try to set the URL automatically.
Allow statistics collectionThis setting enables the collection of usage data to share with JetBrains. Keep this option selected to help us make YouTrack better. We never share collected data with any third party.
Max Upload File SizeThe maximum file size allowed for uploaded attachments, in bytes. By default, the maximum allowed file size is 10Mb (10485760 bytes).
Max ordered issuesYouTrack allows users to re-order issues on the Issues list manually. Users can drag issues in the list and place them in order they see fit. This custom order is saved in a so-called "watch folder", which can be a search query, saved search, tag, project or search context. The Max ordered issues parameter limits the number of issues in the list for which a custom order is set when a user accesses the "watch folder". If you have manually ordered the issues in a saved search, you see up to this number of ordered issues at the top of the list. All other issues that match the saved search are then displayed from newest to oldest.
Max Issues to ExportThe maximum number of issues to be exported as HTML or CSV, or to be exported for printing. By default, the limit is set to 500 issues. To change it, just enter a new value.


The Visual section provides options that let you manage system settings related to the visual presentation in YouTrack.

Default Time ZoneSets the system-wide default time zone. The time zone set here is used for time presentation for all users. Users can change the default time zone in their user profiles.
Date Fields FormatSets the system-wide default date format. This format is applied to all custom fields that use the date field type.

System Language

You can set the system language of your YouTrack server to one of the localizations that are provided out-of-the-box.

You can also upload and enable your own custom localization for the YouTrack user interface.

Enable the RTL support option to align the text input fields and all drop-down lists right-to-left. For more information, see Right-to-Left Language Support.

Keyboard Shortcuts

This section provides options that let you set up the keyboard shortcuts scheme. You can use the default shortcut scheme or add and use your own customized scheme. For more information, see Customize Keyboard Shortcuts.

REST API Settings

In YouTrack, the REST API is always enabled by default.

In addition to the general REST API, we provide support for cross-origin resource sharing, or CORS. CORS support lets you enable Java-script access to your YouTrack instance. For more information, read about cross-origin resource sharing on Wikipedia.
You can also download samples of CORS usage here:

To enable access from a site (origin), select and configure either of the following parameters in the REST API section:

Allow all originsEnable to allow access from all origins with the REST API.
Allowed originsEnter a list of origins for which cross-origin requests are allowed.


This section provides options that let you configure how users are notified of changes to issues in YouTrack.

EmailTo enable sending email notifications from your YouTrack server, select the Enable check box and configure the email settings.
  1. Specify the SMTP host and port used to send messages.
  2. Select the Mail protocol.
  3. Specify the SMTP login and SMTP password used to access the SMTP server.
  4. Select the SSL Key or Trusted Certificate used for secure connection to your mail server. To learn more about uploading SSL keys and trusted certificates, see SSL Keystores.
  5. Enter the email address to use as the "From" address in email messages sent by YouTrack.
  6. To test the connection, click the Send test email button.
JabberTo enable sending notifications over Jabber from your YouTrack server, select the Enable check box and configure the Jabber settings.
  1. Enter the name and port of the Jabber server.
  2. In cases where the service name different from the hostname of the Jabber server, enter the service name. This setting is commonly required for ejabberd servers.
  3. Enter the credentials used to access the Jabber server. For the username, use the format username@domain.
  4. To test the connection, click the Send test jabber message button.
Last modified: 18 April 2017