If chat settings are set, a new button will appear in the chat bar.Clicking on this button will open the settings panel. All settings are editable by the user. Once settings are updated, an event is sent to the Chainlit server so the application can react to the update.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Chainlit","colors":{"primary":"#F80061","light":"#FFE7EB","dark":"#980039"},"logo":{"light":"https://mintcdn.com/chainlit-43/bY2N4qUEa_bGPLfY/logo/light.svg?fit=max\u0026auto=format\u0026n=bY2N4qUEa_bGPLfY\u0026q=85\u0026s=1b972cff6fb5980cf9bfb5c54d6b6821","dark":"https://mintcdn.com/chainlit-43/bY2N4qUEa_bGPLfY/logo/dark.svg?fit=max\u0026auto=format\u0026n=bY2N4qUEa_bGPLfY\u0026q=85\u0026s=2a67b9dc2c050be4fc5095c69d4adbb0","href":"https://github.com/Chainlit/chainlit"},"favicon":"https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/favicon.svg?fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=513b4ccbfc1227b2ee36e6d5bb798e8e","appearance":{"default":"dark","strict":false},"background":{"color":{"dark":"#111010"}},"navbar":{"links":[{"href":"https://github.com/Chainlit/chainlit","label":"Github"}],"primary":{"type":"button","label":"Join Discord","href":"https://discord.gg/k73SQ3FyUh"}},"footer":{"socials":{"github":"https://github.com/Chainlit/chainlit","discord":"https://discord.gg/k73SQ3FyUh","x":"https://x.com/chainlit_io","linkedin":"https://www.linkedin.com/company/chainlit"}},"banner":{"content":"Chainlit is archived and no longer maintained. No bug fixes, security updates, or support are provided. [Read the project status](/get-started/project-status).","dismissible":false},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Chainlit Help","icon":"comment","href":"https://help.chainlit.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"chainlit-43","hasAudioNarration":false,"actualSubdomain":"chainlit-43","customDomains":["docs.chainlit.io"],"gitSource":{"type":"github","owner":"chainlit","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb25e2a0e78eb4aee8763a","collectionId":"50ed0ff5-a69b-41c0-b43c-04c8a1ce621f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb25e2a0e78eb4aee8763a"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adb25e2a0e78eb4aee8763a","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Documentation","count":74},{"language":"default","tag":"API Reference","count":44},{"language":"default","tag":"Get Started","count":13},{"language":"default","tag":"Elements","count":11},{"language":"default","tag":"Integrations","count":11},{"language":"default","tag":"Deploy","count":10},{"language":"default","tag":"Examples","count":10},{"language":"default","tag":"Input Widgets","count":9},{"language":"default","tag":"Basic Concepts","count":9},{"language":"default","tag":"Platforms","count":9}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"advanced-features/chat-settings","slug":"/advanced-features/chat-settings","pageMetadata":{"title":"Chat Settings","description":null,"href":"/advanced-features/chat-settings"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Chat settings are useful to let each user configure their chat experience given a set of options.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works`,children:`How it works`}),`\n`,_jsxs(_components.p,{children:[`Check the chat settings `,_jsx(_components.a,{href:`/api-reference/chat-settings`,children:`API reference`}),` to learn how to configure it.`]}),`\n`,_jsx(Heading,{level:`2`,id:`preview`,children:`Preview`}),`\n`,_jsx(_components.p,{children:`If chat settings are set, a new button will appear in the chat bar.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/open-chat-settings.png?fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=a9ea9b17e4ba16995f24dfc7e67a75bb`,alt:`OpenChatSettings`,\"data-og-width\":`2022`,width:`2022`,\"data-og-height\":`284`,height:`284`,\"data-path\":`images/open-chat-settings.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/open-chat-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=93ea5d8fa3e895e1bea951775e88326f 280w, https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/open-chat-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=3bc5d0b76b71946719f24206f8b6e50a 560w, https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/open-chat-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=fa0c6b29e33df8601a5238eaffad206d 840w, https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/open-chat-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=d5b06e61f891900661f706282878299a 1100w, https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/open-chat-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=fcc2192b6c32812131fe3ec2ece286f0 1650w, https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/open-chat-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=35b53e83e881003dac4258deb0f6ba0d 2500w`}),`\n`,_jsx(_components.p,{children:`Clicking on this button will open the settings panel. All settings are editable by the user. Once settings are updated, an event is sent to the Chainlit server so the application can react to the update.`}),`\n`,_jsx(Frame,{caption:`Chat Settings in Chainlit`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/chat-settings.png?fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=0f43b1020f994bda54a146b5304fbb77`,\"data-og-width\":`952`,width:`952`,\"data-og-height\":`1354`,height:`1354`,\"data-path\":`images/chat-settings.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/chat-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=696ef28d23aa1174adf1db5caac5c12a 280w, https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/chat-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=6758b5b3e0d0239cb59f83a7a62600b7 560w, https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/chat-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=441fd17d5ec7f8b2d88d5596610130d4 840w, https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/chat-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=640440708cfd772cbf9f213661f2b2a7 1100w, https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/chat-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=64559d1b9c3384ebca47873d831ce2a5 1650w, https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/chat-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=b2WeFP1vh0enOZXn\u0026q=85\u0026s=ee57f18bd6cd30491fd22b60192ecab2 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsxs(_components.p,{children:[`Check out this example from the cookbook that uses this feature: `,_jsx(_components.a,{href:`https://github.com/Chainlit/cookbook/tree/main/image-gen`,children:`https://github.com/Chainlit/cookbook/tree/main/image-gen`})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Chat Settings","description":null,"href":"/advanced-features/chat-settings"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How it works","slug":"how-it-works","depth":2,"children":[]},{"title":"Preview","slug":"preview","depth":2,"children":[]},{"title":"Example","slug":"example","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"chainlit-43","siteName":"Chainlit","title":"Chat Settings - Chainlit","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T09:16:26.370Z","originalFileLocation":"advanced-features/chat-settings.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Chainlit\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-43/dEvNex89E1YeuZx8/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-43/dEvNex89E1YeuZx8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-43/dEvNex89E1YeuZx8/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-43/dEvNex89E1YeuZx8/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-43/dEvNex89E1YeuZx8/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-43/dEvNex89E1YeuZx8/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-43/dEvNex89E1YeuZx8/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-43/dEvNex89E1YeuZx8/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/chainlit-43/dEvNex89E1YeuZx8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Chat Settings - Chainlit\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Chainlit\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.chainlit.io/advanced-features/chat-settings\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://chainlit-43.mintlify.app/_mintlify/api/og/v2?division=Advanced+Features\u0026amp;title=Chat+Settings\u0026amp;theme=526b67ea84a41d792424ad38\u0026amp;signature=55f479b6585a5c1940568d28032b80a367c587f8ebfb91d5646150bcb2911182\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Chat Settings - Chainlit\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://chainlit-43.mintlify.app/_mintlify/api/og/v2?division=Advanced+Features\u0026amp;title=Chat+Settings\u0026amp;theme=526b67ea84a41d792424ad38\u0026amp;signature=55f479b6585a5c1940568d28032b80a367c587f8ebfb91d5646150bcb2911182\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/chainlit-43/dEvNex89E1YeuZx8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Chainlit\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F80061\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.chainlit.io/advanced-features/chat-settings\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/advanced-features/chat-settings.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.chainlit.io/#organization\",\"name\":\"Chainlit\",\"url\":\"https://docs.chainlit.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/chainlit-43/bY2N4qUEa_bGPLfY/logo/light.svg?fit=max\u0026auto=format\u0026n=bY2N4qUEa_bGPLfY\u0026q=85\u0026s=1b972cff6fb5980cf9bfb5c54d6b6821\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.chainlit.io#website\",\"name\":\"Chainlit\",\"url\":\"https://docs.chainlit.io\",\"publisher\":{\"@id\":\"https://docs.chainlit.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.chainlit.io/advanced-features/chat-settings#webpage\",\"url\":\"https://docs.chainlit.io/advanced-features/chat-settings\",\"name\":\"Chat Settings\",\"dateModified\":\"2026-10-23T09:16:26.370Z\",\"isPartOf\":{\"@id\":\"https://docs.chainlit.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.chainlit.io/advanced-features/chat-settings#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.chainlit.io/advanced-features/chat-settings#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Advanced Features\",\"item\":\"https://docs.chainlit.io/advanced-features/streaming\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Chat Settings\",\"item\":\"https://docs.chainlit.io/advanced-features/chat-settings\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.chainlit.io/advanced-features/chat-settings#article\",\"headline\":\"Chat Settings\",\"name\":\"Chat Settings\",\"url\":\"https://docs.chainlit.io/advanced-features/chat-settings\",\"mainEntityOfPage\":{\"@id\":\"https://docs.chainlit.io/advanced-features/chat-settings#webpage\"},\"dateModified\":\"2026-10-23T09:16:26.370Z\",\"publisher\":{\"@id\":\"https://docs.chainlit.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.chainlit.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Chainlit\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Chainlit","nav":{"global":{"anchors":[{"anchor":"Chainlit Help","icon":"comment","href":"https://help.chainlit.io"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","pages":[{"title":"Overview","href":"/get-started/overview"},{"title":"Project status","href":"/get-started/project-status"},{"title":"Installation","href":"/get-started/installation"},{"title":"In Pure Python","href":"/get-started/pure-python"},{"group":"Integrations","pages":[{"title":"FastAPI","href":"/integrations/fastapi"},{"title":"LangChain/LangGraph","href":"/integrations/langchain"},{"title":"OpenAI","href":"/integrations/openai"},{"title":"Semantic Kernel","href":"/integrations/semantic-kernel"},{"title":"Mistral AI","href":"/integrations/mistralai"},{"title":"LiteLLM","href":"/integrations/litellm"},{"title":"Llama Index","href":"/integrations/llama-index"},{"title":"Embedchain","href":"/integrations/embedchain"},{"title":"vLLM, LMStudio, HuggingFace","href":"/integrations/message-based"}]}]},{"group":"Deploy","pages":[{"title":"Overview","href":"/deploy/overview"},{"group":"Platforms","pages":[{"title":"Web App","href":"/deploy/webapp"},{"group":"React","pages":[{"title":"Overview","href":"/deploy/react/overview"},{"title":null,"href":"/deploy/react/installation-and-setup"},{"title":null,"href":"/deploy/react/usage"},{"title":null,"href":"/deploy/react/additional-resources"}]},{"title":"Copilot","href":"/deploy/copilot"},{"title":"Teams","href":"/deploy/teams"},{"title":"Slack","href":"/deploy/slack"},{"title":"Discord","href":"/deploy/discord"}]}]},{"group":"Basic Concepts","pages":[{"title":"Chat Life Cycle","href":"/concepts/chat-lifecycle"},{"title":"Starters","href":"/concepts/starters"},{"title":"Message","href":"/concepts/message"},{"title":"Step","href":"/concepts/step"},{"title":"User Session","href":"/concepts/user-session"},{"title":"Element","href":"/concepts/element"},{"title":"Action","href":"/concepts/action"},{"title":"Command","href":"/concepts/command"},{"title":"Modes","href":"/concepts/modes"}]},{"group":"Advanced Features","pages":[{"title":"Streaming","href":"/advanced-features/streaming"},{"title":"MCP","href":"/advanced-features/mcp"},{"title":"Ask User","href":"/advanced-features/ask-user"},{"title":"Multi-Modality","href":"/advanced-features/multi-modal"},{"title":"Chat Profiles","description":null,"href":"/advanced-features/chat-profiles"},{"title":"Chat Settings","href":"/advanced-features/chat-settings"},{"title":"Testing \u0026 Debugging","description":null,"href":"/advanced-features/test-debug"}]},{"group":"Data Persistence","pages":[{"title":"Overview","href":"/data-persistence/overview"},{"title":"Chat History","href":"/data-persistence/history"},{"title":"Human Feedback","href":"/data-persistence/feedback"},{"group":"Open Source Data Layers","pages":[{"title":"Overview","href":"/data-layers/overview"},{"title":"Official Data Layer","href":"/data-layers/official"},{"title":"SQLAlchemy Data Layer","href":"/data-layers/sqlalchemy"},{"title":"DynamoDB Data Layer","href":"/data-layers/dynamodb"}]},{"title":"Tags \u0026 Metadata","href":"/data-persistence/tags-metadata"}]},{"group":"Authentication","pages":[{"title":"Overview","href":"/authentication/overview"},{"title":"Password","href":"/authentication/password"},{"title":"Header","href":"/authentication/header"},{"title":"OAuth","href":"/authentication/oauth"}]},{"group":"Customisation","pages":[{"title":null,"href":"/customisation/overview"},{"title":"Translation","href":"/customisation/translation"},{"title":"Avatars","href":"/customisation/avatars"},{"title":"Logo and Favicon","href":"/customisation/custom-logo-and-favicon"},{"title":"Theme","href":"/customisation/theme"},{"title":"JS","href":"/customisation/custom-js"},{"title":"CSS","href":"/customisation/custom-css"}]},{"group":"Backend","pages":[{"group":"Config","pages":[{"title":"Overview","href":"/backend/config/overview"},{"title":"Project","href":"/backend/config/project"},{"title":"Features","href":"/backend/config/features"},{"title":"UI","href":"/backend/config/ui"}]},{"title":"Environment Variables","href":"/backend/env-variables"},{"title":"Command Line Options","href":"/backend/command-line"}]},{"group":"Guides","pages":[{"title":"Async / Sync","href":"/guides/sync-async"}]},{"group":"Migration Guides","pages":[{"title":"Migrate to Chainlit v2.9.4","href":"/guides/migration/2.9.4"},{"title":"Migrate to Chainlit v2.3.0","href":"/guides/migration/2.3.0"},{"title":"Migrate to Chainlit v2.1.0","href":"/guides/migration/2.1.0"},{"title":"Migrate to Chainlit v2.0.0","href":"/guides/migration/2.0.0"},{"title":"Migrate to Chainlit v1.1.404","href":"/guides/migration/1.1.404"},{"title":"Migrate to Chainlit v1.1.400","href":"/guides/migration/1.1.400"},{"title":"Migrate to Chainlit v1.1.300","href":"/guides/migration/1.1.300"},{"title":"Migrate to Chainlit v1.1.0","href":"/guides/migration/1.1.0"},{"title":"Migrate to Chainlit v1.0.500","href":"/guides/migration/1.0.500"}]}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/examples/cookbook"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/lifecycle-hooks/on-chat-start"}]}]},"basePath":"","title":"Chat Settings - Chainlit","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["10e4515597","a74be98ba7","07c022d89b"],"chunks":["BannerMarkdown-CX_qQQOL.js","dist-BTZUMDnx.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-xpJZXxdP.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","zoom-image-lightbox-BG6oD64b.js","lightbox-handle-r17bVUz3.js","Frame-DXXFP6nH.js","DynamicMarkdown-B54_zNBF.js"]}
