Customizations
Customize the look and behavior of your copilot
Customizations
Customize the appearance, behavior, and branding of your AI copilot.
Theme
Colors
<CopilotChat
theme={{
primaryColor: '#6366f1',
backgroundColor: '#ffffff',
textColor: '#1f2937',
borderRadius: '12px',
}}
/>Dark Mode
<CopilotChat
theme={{
mode: 'dark', // 'light' | 'dark' | 'system'
}}
/>Branding
Custom Header
<CopilotChat
header={{
title: 'Support Assistant',
subtitle: 'How can I help you today?',
logo: '/logo.svg',
}}
/>Welcome Message
<CopilotChat
welcomeMessage="Hi! I'm your AI assistant. Ask me anything about our products."
/>Placeholder
<CopilotChat
placeholder="Type your question here..."
/>Layout
Position
// Floating button (default)
<CopilotChat position="bottom-right" />
// Embedded in page
<CopilotChat embedded={true} />
// Full page
<CopilotChat fullPage={true} />Size
<CopilotChat
width={400}
height={600}
maxHeight="80vh"
/>Input Options
Attachments
<CopilotChat
attachmentsEnabled={true}
allowedFileTypes={['image/*', '.pdf', '.doc']}
maxFileSize={10 * 1024 * 1024} // 10MB
/>Voice Input
<CopilotChat
voiceEnabled={true}
/>Messages
User/AI Avatars
<CopilotChat
userAvatar="/user-avatar.png"
assistantAvatar="/ai-avatar.png"
/>Message Formatting
<CopilotChat
renderMessage={(message) => (
<div className="custom-message">
<Markdown>{message.content}</Markdown>
</div>
)}
/>Behavior
Auto-focus
<CopilotChat
autoFocus={true}
/>Persist History
<CopilotChat
persistHistory={true}
storageKey="my-app-chat"
/>Scroll Behavior
<CopilotChat
scrollBehavior="smooth" // 'smooth' | 'instant' | 'auto'
/>Custom CSS
CSS Variables
:root {
--copilot-primary: #6366f1;
--copilot-bg: #ffffff;
--copilot-text: #1f2937;
--copilot-border: #e5e7eb;
--copilot-radius: 12px;
}Class Names
<CopilotChat
className="my-custom-chat"
classNames={{
container: 'chat-container',
header: 'chat-header',
messages: 'chat-messages',
input: 'chat-input',
}}
/>Full Example
<CopilotChat
// Theme
theme={{
mode: 'system',
primaryColor: '#6366f1',
}}
// Branding
header={{
title: 'AI Assistant',
logo: '/logo.svg',
}}
welcomeMessage="How can I help you today?"
placeholder="Ask anything..."
// Layout
position="bottom-right"
width={400}
// Features
attachmentsEnabled={true}
voiceEnabled={true}
persistHistory={true}
// Avatars
userAvatar="/user.png"
assistantAvatar="/ai.png"
/>Next Steps
- Tools - Add AI capabilities
- Generative UI - Custom tool renderers
- Smart AI Context - Context awareness