Options
The name of both the application and the chatbot.
The content of the <meta name="description"> of the application.
cot
Literal['hidden', 'tool_call', 'full']
default:"full"
The chain of thought (COT) is a feature that shows the user the steps the
chatbot took to reach a conclusion. You can hide the COT, only show the tool
calls, or show it in full.
default_theme
Literal['light', 'dark']
default:"'dark'"
Name of the theme used by default
layout
Literal['default', 'wide']
default:"'open'"
Name of the layout used by default
Passing this option will display a Github-shaped link. If not passed we will
display the link to Chainlit repo.
Custom CSS file that allows you to customize the UI
Custom CSS file tag attributes, i.e. <stylesheet src="public/custom.css" ... ></stylesheet>
Custom JavaScript file that allows you to customize the UI
Custom JavaScript file tag attributes, i.e. <script src="public/custom.js" ... ></script>
alert_style
Literal['classic', 'modern']
default:"'classic'"
Switch between two available alert styles:
'classic': Traditional left-border style'modern': Rounded corners with softer borders and transparent background
Custom image displayed as the background on the login page
Filter applied to the custom background image on the login page
login_page_image_dark_filter
Filter applied to the custom background image on the login page when the dark theme is selected
Content of the <meta property="og:url"> tag. Used in link previews (e.g. iMessage, Twitter). Defaults to the Chainlit GitHub repository URL if not set.
Content of the <meta property="og:image"> tag used for site preview
URL of the image used as the application logo on the welcome screen and during login/logout
URL of the image used as the avatar for messages sent by the assistant
Directory containing custom frontend production build files, if applicable
Additional links displayed in the header next to (or replacing, if not provided) the GitHub link.
Each link supports an optional target field to control how the link opens: _blank (default), _self, _parent, or _top.The target field is available since version 2.8.3.
Default configuration
[UI]
# Name of the assistant.
name = "Assistant"
# default_theme = "dark"
# layout = "wide"
# default_sidebar_state = "open"
# Description of the assistant. This is used for HTML tags.
# description = ""
# Chain of Thought (CoT) display mode. Can be "hidden", "tool_call" or "full".
cot = "full"
# Specify a CSS file that can be used to customize the user interface.
# The CSS file can be served from the public directory or via an external link.
# custom_css = "/public/test.css"
# Specify additional attributes for a custom CSS file
# custom_css_attributes = "media=\\\"print\\\""
# Specify a JavaScript file that can be used to customize the user interface.
# The JavaScript file can be served from the public directory.
# custom_js = "/public/test.js"
# The style of alert boxes. Can be "classic" or "modern".
alert_style = "classic"
# Specify additional attributes for custom JS file
# custom_js_attributes = "async type = \\\"module\\\""
# Custom login page image, relative to public directory or external URL
# login_page_image = "/public/custom-background.jpg"
# Custom login page image filter (Tailwind internal filters, no dark/light variants)
# login_page_image_filter = "brightness-50 grayscale"
# login_page_image_dark_filter = "contrast-200 blur-sm"
# Specify a custom meta url for link previews (og:url).
# custom_meta_url = "https://example.com"
# Specify a custom meta image url.
# custom_meta_image_url = "https://chainlit-cloud.s3.eu-west-3.amazonaws.com/logo/chainlit_banner.png"
# Load assistant logo directly from URL.
logo_file_url = ""
# Load assistant avatar image directly from URL.
default_avatar_file_url = ""
# Specify a custom build directory for the frontend.
# This can be used to customize the frontend code.
# Be careful: If this is a relative path, it should not start with a slash.
# custom_build = "./public/build"
# Specify optional one or more custom links in the header.
# [[UI.header_links]]
# name = "Issues"
# display_name = "Report Issue"
# icon_url = "https://avatars.githubusercontent.com/u/128686189?s=200&v=4"
# url = "https://github.com/Chainlit/chainlit/issues"
# target = "_self" # Optional: _blank (default), _self, _parent, _top
