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 your current license and its limitations.
The graph in this section of the page lets you track whether the number of active users and total disk space exceed the limitations for your license. Potential charges for overuse are shown above the graph, next to the current number of active users and used disk space.
If your YouTrack license has expired, click the Upgrade your subscription button to access the YouTrack website and purchase another license. You can also switch to the free plan, purchase licenses for additional users, or switch between monthly or annual billing. For more information, see Switching Subscription Type.
The System section provides options that let you let you configure the basic system settings of your YouTrack server.
Max upload file size
The maximum file size allowed for uploaded attachments, in bytes. By default, the maximum allowed file size is 10Mb (10485760 bytes).
Max ordered issues
YouTrack lets you reorder 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 saved search, tag, or project. You can update the custom order when you set this watch folder as the 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 export
The maximum number of issues that can be printed or exported in CSV, Excel, or HTML format. By default, the limit is set to 500 issues. To change it, just enter a new value.
The email address of the primary contact for the YouTrack support team. The support team uses this information to determine whether a user is authorized to request major changes to the YouTrack instance. This includes requests to restore the database or migrate data between instances.
Data center location
The location of the data center that hosts your YouTrack InCloud instance. This value is set when the instance is registered. If you want to move your instance to a different data center, submit a request to YouTrack InCloud Support.
The Visual section provides options that let you manage system settings related to the visual presentation in YouTrack.
Sets a custom logo for YouTrack. The custom logo is displayed in the header for all pages in the system. To use a custom logo, click the Edit icon, then choose an image file from your local directory. You can upload a JPG, GIF, or PNG file. Your image is automatically resized to 250 x 80 pixels.
This set of controls determines the system-wide default time zone. The time zone set here is used for time presentation for all users. Users can change the local time zone in their user profiles.
Sets the system-wide default presentation for dates and times. This format is applied to all custom fields that use the date field type.
You can set the system language of your YouTrack server to one of the localizations that are provided out-of-the-box. YouTrack provides localization support for English, German, French, Japanese, Russian, and Spanish.
Users can select their personal language preference in their user profile. For consistency across the application, the language that is set at the global level is used for search queries, commands, and custom fields. The page headers, menus, and controls are displayed in the preferred locale. For more information, see YouTrack General Profile Settings.
Enable the RTL support option to align the text input fields and all drop-down lists right-to-left. Use this option when your users create issues in a language that is written from right to left.
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.
In YouTrack, the REST API is always enabled.
To enable access from a site (origin), select and configure either of the following parameters in the REST API section of the page:
Allow all origins
Enable to allow access from all origins with the REST API.
Enter a line-separated list of origins for which cross-origin requests are allowed. Specify each origin by domain name, including protocol and port number where applicable.
This section provides options that let you configure how users are notified of changes to issues in YouTrack.
In YouTrack InCloud, email notifications are enabled and configured by default. This section of the settings page lets you view the configuration used to send email notifications to users.
If you use the mail server that is hosted on our servers, we strongly recommend that you leave these settings unchanged. However, you may want to change the email address that is used as the 'From' address in email messages sent by YouTrack. For more information, see From and Reply-to Addresses.
You also have the option to overwrite these settings completely and connect YouTrack to your own mail server. For detailed instructions, see Connect to an External Mail Server.
To disable sending email notifications from your YouTrack server, deselect the Enable checkbox.
This control enables or disables email notifications in YouTrack.
The server address of your mail server.
The connection port for the mail server.
The protocol that is used by your mail server.
When enabled, YouTrack connects to your SMTP server without sending a login and password. Use when your SMTP server does not require authentication.
When this option is enabled, the input fields for SMTP login and SMTP password are disabled. Values that are stored in these settings are ignored.
The username of the account that is used to access the mail server.
The password for the account that is used to access the mail server.
This list lets you select an SSL key that contains a trusted certificate and its public and private key pairs. The key identifies YouTrack as a client when it tries to connect to your mail server.
The default address for sending email notifications from YouTrack. This sets the value for the
An optional address to which email replies are sent. This sets the value for the
Send test email
This control lets you test the connection to your mail server by sending a test message to a specific email address.
In YouTrack InCloud, notifications over Jabber are enabled and configured by default. This section of the settings page lets you view the configuration used to send messages over Jabber and the system account from which notifications are sent to users.
If you use the Jabber service that is provided by YouTrack, we strongly recommend that you leave these settings unchanged.
You also have the option to overwrite these settings completely and connect YouTrack to your own Jabber service. For detailed instructions, see Enable Notifications over Jabber.
Here, you also find the option that lets users interact with YouTrack through direct messages in a Jabber client — the Jabber Bot. For more information, see Search for Issues over Jabber and Apply Commands over Jabber.
To disable sending notifications over Jabber, deselect the Enable check box.
This control enables or disables Jabber notifications in YouTrack.
The server address of your Jabber service.
Jabber server port
The connection port for the Jabber service.
Jabber service name
The name of your Jabber service. Use when the service name and address (hostname) are not the same. This setting is commonly required for
The username of the account that is used to access the Jabber service. Use the format
The password for the account that is used to access the Jabber service.
This list lets you select an SSL keystore that contains a trusted certificate and its public and private key pairs. The keystore identifies YouTrack as a client when it tries to connect to the Jabber service.
Use legacy SSL
This option disables the certificate validity check for the SSL connection. Recommended only when you are using
Send test jabber message
This control lets you test the connection to your Jabber service by sending a test message to a specific Jabber account.
Enable Jabber bot
This option allows users to interact with YouTrack through direct messages in a Jabber client.
Sending Notification to External Applications
Third-party developers can build applications that pull notifications from YouTrack and display them in an external application. This functionality is supported by the YouTrack REST API.
When you enable the External applications setting in the Notifications section of the page, the REST API is exposed to external applications. Notifications that are sent by email or Jabber can also be displayed in applications that support this functionality.
The following applications use the REST API to display notifications in an external client:
To make these features available for your users, enable this option.
This link provides access to the Feature Configuration page. Here, you find a list of experimental features that you can enable system-wide and other features that you can enable for specific groups.
For more information, see Experimental Features.
This link opens a page that lets you add the YouTrack App to a workspace in Slack. For more information, see YouTrack App for Slack.