Widget options

The same options are accepted as React props on <ChatWidget>, as keys on the window.ClaudiusConfig global (script embed), and — for a subset — as attributes on the <claudius-chat> web component.

Option	Type	Default	Description
`apiUrl`	`string`	(required)	URL of your Cloudflare Worker
`title`	`string`	`"Chat"`	Header title
`subtitle`	`string`	`"Ask me anything"`	Header subtitle
`welcomeMessage`	`string`	`"Hi! How can I help you today?"`	First assistant message shown
`placeholder`	`string`	`"Type your message..."`	Input placeholder
`persistMessages`	`boolean`	`true`	Save history to `sessionStorage` (survives navigation, clears on tab close)
`storageKeyPrefix`	`string`	`"claudius:messages"`	Storage key prefix; set a unique value per widget when embedding several on one page
`requestTimeoutMs`	`number`	`30000`	Per-attempt request timeout; `0` disables. Timeouts surface a retryable error
`theme`	`"light" \| "dark" \| "auto"` \| theme name \| `ClaudiusTheme` \| URL	`"light"`	Color scheme, a built-in theme, an inline theme object, or a URL to a theme JSON file
`accentColor`	`string`	`"#2563eb"`	Primary brand color override
`position`	`"bottom-right" \| "bottom-left" \| "top-right" \| "top-left"`	`"bottom-right"`	Corner the bubble and window anchor to
`locale`	`"en" \| "es" \| "fr" \| "de"`	auto-detected	UI language; see Localization
`translations`	`Partial<ClaudiusTranslations>`	built-in	Override individual UI strings
`triggers`	`Trigger[]`	`undefined`	Proactive triggers; see Proactive triggers
`plugins`	`ClaudiusPlugin[]`	`undefined`	Message middleware run around each send (`onBeforeSend` / `onAfterReceive` / `onError`); see Plugins
`attachments`	`boolean \| AttachmentsOptions`	`false`	Let visitors attach images and PDFs; `true` for the defaults (5 MB, 5 files) or an object with `maxSizeBytes`, `maxCount`, `allowedTypes`. See Attachments
`voice`	`boolean \| VoiceOptions`	`false`	Mic button for dictation and a read-aloud button on replies, using the browser’s Web Speech API; `true` for the defaults or an object with `input`, `output`, `mode`, `autoSubmit`, `lang`. See Voice
`conversationExport`	`boolean`	`false`	Header menu that copies the conversation as Markdown, or downloads it as Markdown or JSON. Runs in the browser; nothing is sent to the worker. See Conversation export

Web component attributes

<claudius-chat> supports the scalar options as kebab-case attributes: api-url, title, subtitle, welcome-message, placeholder, persist-messages, storage-key-prefix, request-timeout-ms, theme, accent-color, position, attachments (attachments or attachments="true" enables the defaults), voice with its companions voice-mode, voice-auto-submit, voice-input, voice-output, and voice-lang (see Voice), and conversation-export (see Conversation export).

<claudius-chat
  api-url="https://your-worker.workers.dev"
  title="Support"
  theme="auto"
></claudius-chat>

locale, translations, triggers, and plugins are not available as attributes — use window.ClaudiusConfig or the React component for those. (plugins are functions, so set them in JS via window.ClaudiusConfig or as a React prop.)

Checking the deployed version

The embed sets window.ClaudiusWidgetVersion; inspect it in the browser console to see which release a page is running.