Skip to content

SettingsState ​

Properties ​

addQueryDepthLimit ​

addQueryDepthLimit: number

Specifies how deep the 'Add query' functionality should go. You can specify any valid positive integer.


alert.disableUpdateNotification? ​

optional alert.disableUpdateNotification: boolean

Disable update notification


alert.disableWarnings? ​

optional alert.disableWarnings: boolean

Disable warning alerts


beta.disable.newEditor? ​

optional beta.disable.newEditor: boolean

Disable new editor beta


beta.disable.newScript? ​

optional beta.disable.newScript: boolean

Disable new script beta


disableLineNumbers? ​

optional disableLineNumbers: boolean

Disable line numbers


disablePushNotification? ​

optional disablePushNotification: boolean

Specifies if native push notifications should be disabled

Default ​

ts
false

doc.hideDeprecatedItems? ​

optional doc.hideDeprecatedItems: boolean

Hides deprecated Doc items


editor.shortcuts? ​

optional editor.shortcuts: Record<string, string>

Contains shortcut to action mapping


enableExperimental? ​

optional enableExperimental: boolean

Enable experimental features. Note: The features might be unstable

Default ​

ts
false

enableTablistScrollbar? ​

optional enableTablistScrollbar: boolean

Enable the scrollbar in the tab list


historyDepth? ​

optional historyDepth: number

Number of items allowed in history pane


introspection.options.description? ​

optional introspection.options.description: boolean

Whether to include descriptions in the introspection result


introspection.options.directiveIsRepeatable? ​

optional introspection.options.directiveIsRepeatable: boolean

Whether to include isRepeatable flag on directives


introspection.options.inputValueDeprecation? ​

optional introspection.options.inputValueDeprecation: boolean

Whether target GraphQL server supports deprecation of input values


introspection.options.schemaDescription? ​

optional introspection.options.schemaDescription: boolean

Whether to include description field on schema


introspection.options.specifiedByUrl? ​

optional introspection.options.specifiedByUrl: boolean

Whether to include specifiedByUrl in the introspection result


language ​

language: "en-US" | "fr-FR" | "es-ES" | "cs-CZ" | "de-DE" | "pt-BR" | "ru-RU" | "uk-UA" | "zh-CN" | "ja-JP" | "sr-SP" | "it-IT" | "pl-PL" | "ko-KR" | "ro-RO" | "vi-VN"

Specifies the language


plugin.list? ​

optional plugin.list: string[]

Specifies a list of enabled plugins.

Plugins are specified in a string format <plugin-source>:<plugin-name>@<version>::[<opt>]->[<opt-value>]:

  • <plugin-source>: The source of the plugin. Can be 'npm', 'url' or 'github'
  • <plugin-name> (required): The name of the plugin. Plugin names must begin with altair-graphql-plugin-
  • <version>: The version of the plugin. If not specified, the latest version will be used
  • [<opt>]->[<opt-value>]: Additional configuration for the plugin. This is used when you specify the source as 'url'. In this case, you can specify the URL where the plugin is hosted.

Example ​

ts
['altair-graphql-plugin-some-plugin', 'npm:altair-graphql-plugin-some-plugin', 'npm:[email protected]', 'url:[email protected]::[url]->[http://example.com/some-plugin]']

Default ​

ts
[]

request.withCredentials? ​

optional request.withCredentials: boolean

Send requests with credentials (cookies)


response.hideExtensions? ​

optional response.hideExtensions: boolean

Hides extensions object


response.stream.strategy? ​

optional response.stream.strategy: MultiResponseStrategy

Determine the handling strategy for multiple responses


schema.reloadOnStart? ​

optional schema.reloadOnStart: boolean

Reload schema on app start


script.allowedCookies? ​

optional script.allowedCookies: string[]

List of cookies to be accessible in the pre-request script

Example ​

ts
['cookie1', 'cookie2']

Default ​

ts
[]

tabSize ​

tabSize: number

Specifies the tab size for the editor


theme ​

theme: string

Specifies the theme. Themes available by default are 'light', 'dark', 'system', 'dracula'. Additional themes can be added via plugins.

Default ​

ts
'system'

theme.dark? ​

optional theme.dark: string

Specifies the theme for dark mode


theme.editorFontFamily? ​

optional theme.editorFontFamily: string

Specifies the font family for the editors. Any valid CSS font family combination can be used here


theme.editorFontSize? ​

optional theme.editorFontSize: number

Specifies the font size for the editors


theme.fontsize? ​

optional theme.fontsize: number

Specifies the base font size

Default ​

ts
24

themeConfig? ​

optional themeConfig: RecursivePartial<ITheme>

Specify custom theme config to override the specified theme values


themeConfig.dark? ​

optional themeConfig.dark: RecursivePartial<ITheme>

Theme config object for dark mode