--- metadata: - name: generator content: Diplodoc Platform v5.63.0 alternate: - en/settings/appearance - ru/settings/appearance - href: en/settings/appearance.md type: text/markdown title: Markdown version csp: - script-src: - https://mc.yandex.ru img-src: - https://mc.yandex.ru connect-src: - https://mc.yandex.ru - wss://mc.yandex.ru child-src: - 'blob:' - https://mc.yandex.ru frame-src: - 'blob:' - https://mc.yandex.ru frame-ancestors: - 'blob:' - https://mc.yandex.ru canonical: en/settings/appearance.html title: Appearance settings in DataLens On-premises description: >- The DataLens On-premises appearance settings enable you to change how the interface looks. vcsPath: en/settings/appearance.md --- # General settings in DataLens On-premises General settings allow you to change the visual look of the interface for the entire organization: * [Customize the UI](#ui-customization). * Add, edit, or delete chart [color palettes](#palette-settings). * Manage [workbook export](#workbooks-export-disable). * Manage [data export from charts](../concepts/chart/data-export.md#data-export-disable). These settings can be edited by the DataLens instance [administrator](../security/roles.md#datalens-admin) (the `datalens.admin` role). To access the general settings: 1. In the left-hand panel, select **Service settings**. If the panel does not feature , first select **More**, then **Service settings**. 1. Select the **General** tab. ## UI customization {#ui-customization} With UI customization, you can achieve a custom DataLens look by editing colors, logo, and redesigning individual elements. The customization settings can be edited by the DataLens instance [administrator](../security/roles.md#datalens-admin) (the `datalens.admin` role). For UI customization: 1. Go to the DataLens home page. 1. In the left-hand panel, select **Service settings**. 1. Select the **Appearance** tab. 1. In the **UI customization** section, click **Configure**. 1. Customize the design: * **UI theme**: Select the UI theme for which you want to set the color palette. * **Contrast**: Select the contrast for which you want to set the color palette. * **Color palette**: Select colors for the UI theme and contrast. You can customize a unique palette for each combination of theme and contrast. You can set the colors manually or generate them: {% list tabs %} - Manually * **Main color**: Used as a background for buttons and controls: switches, checkboxes, and selectors. Additionally, the main color is used as a theme for tooltips. * **Main color on hovering the cursor**: When manually customized, you can select any color. When generating a palette, a darker shade of the main color is set automatically. * **Page background**: Page background color. For a light theme, white is the most commonly used color. Dark themes have more options, from neutral gray shades to warm or cool colors. * **Additional color**: Background color applied to cards and other elevated elements. * **Selected elements**: Color for selected elements, e.g., clicked buttons, selected rows, or selected text. * **Selected items when hovering the cursor**: Color for selected items (e.g., clicked buttons or selected rows) when hovering over them. * **Text on selected items**: Text color on selected items. Set it to contrast with the color of the selected elements. * **Lines and outlines**: Color of the active card or tab, as well as the color of the loading indicator. * **Link**: Link text color. * **Link on hover**: Link text color when the cursor hovers over it. - Generate Click **Generate palette** and select the main color. Other colors will be automatically generated based on it. If required, edit the color settings manually. {% endlist %} * **Contrasting color**: Select a color for the text on the button. * **Logo and favicon**: To replace the logo and favicon, insert a link to a 1:1 aspect ratio SVG file into this field. Click **Apply** next to the field. * **Rounding**: Sets corner rounding for UI elements. {% note info %} The preview area displays how the UI elements will look like with the specified settings. {% endnote %} 1. At the top right, click **Save**. 1. To apply the customized UI, enable the corresponding option under **UI customization**. ## Managing a chart color palette {#palette-settings} In DataLens On-premises, you can [create](#create-palette), [edit](#edit-palette), or [delete](#delete-palette) a color palette and [configure the default palette](#default-palette). ### Creating a color palette {#create-palette} To create a color palette: 1. Go to the DataLens home page. 1. In the left-hand panel, select **Service settings**. 1. Select the **Appearance** tab. 1. Under **Palettes**, add a new palette: {% list tabs %} - Gradient color palette A gradient color palette is used in charts for numerical measures. 1. Go to **Gradient color palettes** and click **+ Add palette**. 1. In the window that opens, enter the following parameters: * Enter the **Palette name** at the top. * Enter the start value for the gradient color at the bottom left and its end value at the bottom right. For example, specify `0044A3` on the left and `8CCBFF` on the right for a dark blue to light blue gradient. To add an intermediate gradient value, click below and specify the value. You can check the changes in the preview window. 1. Click **Save**. - Color palette A color palette is used in charts for discrete values: measure names, dimension values. 1. Go to **Color palettes** and click **+ Add palette**. 1. In the window that opens, enter the following parameters: * Enter the **Palette name** at the top. * In the list on the right, click **+ Add color** and enter values for palette colors, in hex format. There are 20 default colors. You can edit, add, or delete palette colors. To change the order of colors, drag them using the mouse. You can check the changes in the preview window. 1. Click **Save**. {% endlist %} ### Changing a color palette {#edit-palette} To change a color palette: 1. Go to the DataLens home page. 1. In the left-hand panel, select **Service settings**. 1. Select the **Appearance** tab. 1. Go to **Palettes** and click the line with the palette to change. 1. Make changes in the **Configure color palettes** window. 1. Click **Save**. ### Deleting a color palette {#delete-palette} {% note info %} Deleting a color palette resets the [color settings](../concepts/chart/settings.md#color-settings) in all charts where it was used. {% endnote %} To delete a color palette: 1. Go to the DataLens home page. 1. In the left-hand panel, select **Service settings**. 1. Select the **Appearance** tab. 1. Go to **Palettes** and hover over the name of the palette to delete. 1. Click next to it and select **Delete**. 1. Click **Delete**. ### Setting the default color palette {#default-palette} To set any of the preinstalled or previously added color palettes as default: 1. Go to the DataLens home page. 1. In the left-hand panel, select **Service settings**. 1. Select the **Appearance** tab. 1. Under **Palettes**, select the default palette from the list. The default palette will be applied to all charts that use it. In charts with custom palette settings, the palette will not change. If you delete the default color palette, the `Default 20` palette will apply instead. It will be applied to all charts that use the default palette. ## Disabling workbook export {#workbooks-export-disable} By default, users with the `datalens.admin` role can export workbooks. You can disable this option at the DataLens instance level. After you prohibit export: * **Export** button will disappear from the workbook interface. * Users will not be able to export workbooks. * Any JSON export files created before you disable export may be imported to a new workbook. Only the DataLens instance [admin](../security/roles.md#datalens-admin), i.e., a user with the `datalens.admin` role, can disable export. To prohibit export of workbooks: 1. In the left-hand panel, select **Service settings**. 1. Select the **General** tab. 1. Disable **Workbook export** (enabled by default).