> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# IPermanentSettings

- Package: [@gooddata/sdk-model](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/index.md)
- Kind: interface
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-model/src/settings/settings.ts

Setting properties are used to customize platform behavior for end users. These are permanent setting options that are intended to remain, unlike feature-flag-based settings.

On the Panther/Tiger platform, each setting is backed by a metadata object with a unique setting type registered in the backend.

**Signature:**

```typescript
export interface IPermanentSettings 
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [activeCalendars?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsactivecalendars) |  | [IActiveCalendars](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iactivecalendars/index.md) | _(Optional)_ Active calendars configuration |
| [activeLlmProvider?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsactivellmprovider) |  | [ILlmActiveProvider](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.illmactiveprovider/index.md) | _(Optional)_ LLM provider id as default for the platform. |
| [ADCatalogGroupsExpanded?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsadcataloggroupsexpanded) |  | boolean | _(Optional)_ Indicates whether the catalog groups in analytical designer are expanded by default. |
| [aiRateLimit?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsairatelimit) |  | [IAiRateLimit](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iairatelimit/index.md) | _(Optional)_ AI rate limit configuration: max interactions per rolling time window. |
| [alertDefault?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsalertdefault) |  | [IAlertDefault](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ialertdefault/index.md) | _(Optional)_ Represents alert default configuration |
| [allowUnsafeFlexConnectEndpoints?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsallowunsafeflexconnectendpoints) |  | boolean | _(Optional)_ If true, non-TLS endpoints may be used for FlexConnect. Otherwise, only TLS-enabled endpoints may be used. |
| [attachmentSizeLimit?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsattachmentsizelimit) |  | number \| null | _(Optional)_ Attachment size limit in bytes (null for no limit). |
| [currencyFormatOverride?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingscurrencyformatoverride) |  | string \| null | **_(ALPHA)_** _(Optional)_ Resolved currency format override from metricFormatOverride.formats["CURRENCY"]. This is a convenience property normalized during settings resolution. |
| [dashboardFiltersApplyMode?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsdashboardfiltersapplymode) |  | [DashboardFiltersApplyMode](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.dashboardfiltersapplymode/index.md) | **_(ALPHA)_** _(Optional)_ Represents configuration for Dashboard Filters Apply Mode |
| [dataLocale?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsdatalocale) |  | string | _(Optional)_ Locale code to use for data values. |
| [dateFilterConfig?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsdatefilterconfig) |  | [IDateFilterConfig](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.idatefilterconfig/index.md) | **_(ALPHA)_** _(Optional)_ Date filter configuration. |
| [defaultExportTemplate?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsdefaultexporttemplate) |  | [IDefaultExportTemplate](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.idefaultexporttemplate/index.md) | **_(BETA)_** _(Optional)_ Default export template applied to slide exports when none is explicitly requested. |
| [defaultMetricVisibility?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsdefaultmetricvisibility) |  | [ObjectVisibility](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objectvisibility/index.md) | **_(ALPHA)_** _(Optional)_ Who can view a newly created metric. Applies only with `enableMetricPermissions`. The backend treats an unset value as RESTRICTED. |
| [defaultVisualizationVisibility?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsdefaultvisualizationvisibility) |  | [ObjectVisibility](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objectvisibility/index.md) | **_(ALPHA)_** _(Optional)_ Who can view a newly created visualization. Applies only with `enableVisualizationPermissions`. The backend treats an unset value as RESTRICTED. |
| [disableKpiDashboardHeadlineUnderline?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsdisablekpidashboardheadlineunderline) |  | boolean | _(Optional)_ Headline component will not be underlined when it is set up with drilling. |
| [earlyAccessFeatures?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsearlyaccessfeatures) |  | [IEarlyAccessFeaturesConfig](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iearlyaccessfeaturesconfig/index.md) | **_(BETA)_** _(Optional)_ Early access features configuration. |
| [enableAutomationEvaluationMode?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsenableautomationevaluationmode) |  | boolean | _(Optional)_ Enable automation evaluation mode. |
| [exportCsvCustomDelimiter?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsexportcsvcustomdelimiter) |  | string | _(Optional)_ Default delimiter to use for CSV exports when not overridden by request. |
| [exportResultPollingTimeoutSeconds?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsexportresultpollingtimeoutseconds) |  | number | _(Optional)_ Override the default timeout for polling for the export results. |
| [fiscalYear?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsfiscalyear) |  | [IFiscalYear](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ifiscalyear/index.md) | _(Optional)_ Fiscal year calendar configuration |
| [formatLocale?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsformatlocale) |  | string | _(Optional)_ Locale code to use for date formatting. |
| [grantManageVisualizationsWithAnalyze?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsgrantmanagevisualizationswithanalyze) |  | boolean | **_(ALPHA)_** _(Optional)_ When true, granting ANALYZE on the workspace also grants the MANAGE\_VISUALIZATIONS workspace permission, and revoking ANALYZE revokes it. Changing the setting leaves stored grants as they are. |
| [llmEndpoint?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsllmendpoint) |  | [ILlmEndpoint](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.illmendpoint/index.md) | _(Optional)_ LLM endpoint id as default for the platform. |
| [maxZoomLevel?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsmaxzoomlevel) |  | number \| null | _(Optional)_ Maximum zoom level applied to geo visualizations. |
| [metadataLocale?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsmetadatalocale) |  | string | _(Optional)_ Locale code to use for metadata. |
| [metadataTimeZone?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsmetadatatimezone) |  | string | _(Optional)_ IANA identifier of time zone in which the platform metadata are stored. |
| [metricFormatOverride?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsmetricformatoverride) |  | [IMetricFormatOverrideSetting](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imetricformatoverridesetting/index.md) | **_(ALPHA)_** _(Optional)_ Metric format override configuration. |
| [openAiConfig?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsopenaiconfig) |  | [IOpenAiConfig](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iopenaiconfig/index.md) | **_(ALPHA)_** _(Optional)_ Represents configuration for OpenAI integration |
| [platformEdition?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsplatformedition) |  | [PlatformEdition](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.platformedition/index.md) | _(Optional)_ Indicates current platform edition. |
| [responsiveUiDateFormat?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsresponsiveuidateformat) |  | string | _(Optional)_ Indicates the format in which the dates will be displayed |
| [restrictBaseUi?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsrestrictbaseui) |  | boolean | _(Optional)_ Restrict access to Base UI applications. |
| [showHiddenCatalogItems?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsshowhiddencatalogitems) |  | boolean | _(Optional)_ Indicates whether unavailable data items are visible in the settings API only available on Tiger/Panther |
| [timezone?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingstimezone) |  | string | _(Optional)_ Timezone |
| [weekStart?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingsweekstart) |  | [WeekStart](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.weekstart/index.md) | _(Optional)_ Week start day |
| [whiteLabeling?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipermanentsettings/index.md#ipermanentsettingswhitelabeling) |  | [IWhiteLabeling](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iwhitelabeling/index.md) | _(Optional)_ Represents whiteLabeling configuration |

## Property details

### IPermanentSettings.activeCalendars

Active calendars configuration

**Signature:**

```typescript
activeCalendars?: IActiveCalendars;
```

### IPermanentSettings.activeLlmProvider

LLM provider id as default for the platform.

**Signature:**

```typescript
activeLlmProvider?: ILlmActiveProvider;
```

### IPermanentSettings.ADCatalogGroupsExpanded

Indicates whether the catalog groups in analytical designer are expanded by default.

**Signature:**

```typescript
ADCatalogGroupsExpanded?: boolean;
```

### IPermanentSettings.aiRateLimit

AI rate limit configuration: max interactions per rolling time window.

**Signature:**

```typescript
aiRateLimit?: IAiRateLimit;
```

### IPermanentSettings.alertDefault

Represents alert default configuration

**Signature:**

```typescript
alertDefault?: IAlertDefault;
```

### IPermanentSettings.allowUnsafeFlexConnectEndpoints

If true, non-TLS endpoints may be used for FlexConnect. Otherwise, only TLS-enabled endpoints may be used.

**Signature:**

```typescript
allowUnsafeFlexConnectEndpoints?: boolean;
```

### IPermanentSettings.attachmentSizeLimit

Attachment size limit in bytes (null for no limit).

**Signature:**

```typescript
attachmentSizeLimit?: number | null;
```

### IPermanentSettings.currencyFormatOverride

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Resolved currency format override from metricFormatOverride.formats["CURRENCY"]. This is a convenience property normalized during settings resolution.

**Signature:**

```typescript
currencyFormatOverride?: string | null;
```

### IPermanentSettings.dashboardFiltersApplyMode

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Represents configuration for Dashboard Filters Apply Mode

**Signature:**

```typescript
dashboardFiltersApplyMode?: DashboardFiltersApplyMode;
```

### IPermanentSettings.dataLocale

Locale code to use for data values.

**Signature:**

```typescript
dataLocale?: string;
```

### IPermanentSettings.dateFilterConfig

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Date filter configuration.

**Signature:**

```typescript
dateFilterConfig?: IDateFilterConfig;
```

### IPermanentSettings.defaultExportTemplate

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Default export template applied to slide exports when none is explicitly requested.

**Signature:**

```typescript
defaultExportTemplate?: IDefaultExportTemplate;
```

### IPermanentSettings.defaultMetricVisibility

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Who can view a newly created metric. Applies only with `enableMetricPermissions`. The backend treats an unset value as RESTRICTED.

**Signature:**

```typescript
defaultMetricVisibility?: ObjectVisibility;
```

### IPermanentSettings.defaultVisualizationVisibility

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Who can view a newly created visualization. Applies only with `enableVisualizationPermissions`. The backend treats an unset value as RESTRICTED.

**Signature:**

```typescript
defaultVisualizationVisibility?: ObjectVisibility;
```

### IPermanentSettings.disableKpiDashboardHeadlineUnderline

Headline component will not be underlined when it is set up with drilling.

**Signature:**

```typescript
disableKpiDashboardHeadlineUnderline?: boolean;
```

### IPermanentSettings.earlyAccessFeatures

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Early access features configuration.

**Signature:**

```typescript
earlyAccessFeatures?: IEarlyAccessFeaturesConfig;
```

### IPermanentSettings.enableAutomationEvaluationMode

Enable automation evaluation mode.

**Signature:**

```typescript
enableAutomationEvaluationMode?: boolean;
```

### IPermanentSettings.exportCsvCustomDelimiter

Default delimiter to use for CSV exports when not overridden by request.

**Signature:**

```typescript
exportCsvCustomDelimiter?: string;
```

### IPermanentSettings.exportResultPollingTimeoutSeconds

Override the default timeout for polling for the export results.

**Signature:**

```typescript
exportResultPollingTimeoutSeconds?: number;
```

### IPermanentSettings.fiscalYear

Fiscal year calendar configuration

**Signature:**

```typescript
fiscalYear?: IFiscalYear;
```

### IPermanentSettings.formatLocale

Locale code to use for date formatting.

**Signature:**

```typescript
formatLocale?: string;
```

### IPermanentSettings.grantManageVisualizationsWithAnalyze

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

When true, granting ANALYZE on the workspace also grants the MANAGE\_VISUALIZATIONS workspace permission, and revoking ANALYZE revokes it. Changing the setting leaves stored grants as they are.

**Signature:**

```typescript
grantManageVisualizationsWithAnalyze?: boolean;
```

### IPermanentSettings.llmEndpoint

LLM endpoint id as default for the platform.

**Signature:**

```typescript
llmEndpoint?: ILlmEndpoint;
```

### IPermanentSettings.maxZoomLevel

Maximum zoom level applied to geo visualizations.

**Signature:**

```typescript
maxZoomLevel?: number | null;
```

#### Remarks

Null or undefined means that zoom is unrestricted and default chart settings will be applied.

### IPermanentSettings.metadataLocale

Locale code to use for metadata.

**Signature:**

```typescript
metadataLocale?: string;
```

### IPermanentSettings.metadataTimeZone

IANA identifier of time zone in which the platform metadata are stored.

**Signature:**

```typescript
metadataTimeZone?: string;
```

### IPermanentSettings.metricFormatOverride

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Metric format override configuration.

**Signature:**

```typescript
metricFormatOverride?: IMetricFormatOverrideSetting;
```

### IPermanentSettings.openAiConfig

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Represents configuration for OpenAI integration

**Signature:**

```typescript
openAiConfig?: IOpenAiConfig;
```

### IPermanentSettings.platformEdition

Indicates current platform edition.

**Signature:**

```typescript
platformEdition?: PlatformEdition;
```

### IPermanentSettings.responsiveUiDateFormat

Indicates the format in which the dates will be displayed

**Signature:**

```typescript
responsiveUiDateFormat?: string;
```

### IPermanentSettings.restrictBaseUi

Restrict access to Base UI applications.

**Signature:**

```typescript
restrictBaseUi?: boolean;
```

### IPermanentSettings.showHiddenCatalogItems

Indicates whether unavailable data items are visible in the settings API only available on Tiger/Panther

**Signature:**

```typescript
showHiddenCatalogItems?: boolean;
```

### IPermanentSettings.timezone

Timezone

**Signature:**

```typescript
timezone?: string;
```

### IPermanentSettings.weekStart

Week start day

**Signature:**

```typescript
weekStart?: WeekStart;
```

### IPermanentSettings.whiteLabeling

Represents whiteLabeling configuration

**Signature:**

```typescript
whiteLabeling?: IWhiteLabeling;
```