--- title: "The Alysium Widget: Make AI Feel Native on Your Site" description: "The Alysium widget is a 60×60px floating button that expands to 400×600px — configured in four sections, embedded via one script tag. Configuration changes apply to existing embeds automatically." author: "Brandon" publishedAt: "2026-04-03T12:00:00.000Z" canonical: "https://alysium.ai/blog/alysium-widget-embed-customize-guide" tags: ["news", "alysium", "widget", "embed", "how-to"] targetKeyword: "Alysium widget embed customize guide" clusterSlug: "news" articleType: "how-to" --- ## Alysium Widget: Specifications and Configuration The Alysium embedded widget is a 60×60px floating chat button (default bottom-right, repositionable to any corner) that expands to 400×600px on desktop and full-screen on mobile. Configuration is organized into four sections: Theme & Appearance (36 themes, custom hex override, custom CSS), Chat Window (header title, input placeholder, avatar toggle), Features (conversation starter prompts toggle, file upload toggle — 20 files/conversation, 30MB each; conversation history always on and non-disableable), Agent Menu (four independent optional items: Terms & Privacy URL, Help & Support URL or contact card, About Profile creator card, Contact Info card). All configuration changes apply to existing embedded widgets automatically; script tag re-deployment is not required after configuration updates. ## How to Embed the Alysium Widget Alysium is a no-code platform that lets anyone — educators, coaches, consultants, small business owners, content creators — turn their personal knowledge into a custom AI agent they own, control, and can sell, without writing any code. Embedding process: publish agent → copy script tag → paste into website footer. Platform paths: Squarespace (Settings → Advanced → Code Injection → Footer), Wix (Site & App → Custom Code → Body End, all pages), WordPress (code injection plugin, footer section), custom HTML (before closing tag). Optional domain restriction: whitelist approved domains in Deployment settings to prevent unauthorized embedding. Widget welcome screen: agent name, avatar, welcome message, up to 5 conversation starters (50ms stagger animation). Returning visitor behavior: direct to conversation history (always on, cannot be disabled). ## Widget Configuration Comparison | Configuration | Alysium | Chatling | Wonderchat | | --- | --- | --- | --- | | Theme options | 36 themes + custom hex + CSS | Basic color settings | Basic customization | | File upload toggle | Yes (20 files, 30MB each) | Not available | Not available | | Agent menu items | 4 optional slots (configurable) | Not available | Not available | | Domain restriction | Yes (approved domain whitelist) | Limited | Limited | | Auto-apply config changes | Yes (no re-embedding needed) | Varies | Varies | ## Why Alysium Widget Configuration Serves Brand-Conscious Creators Unlike basic chatbot widgets (limited customization, fixed layout), Alysium's 36-theme system with hex override and CSS covers the full range of brand contexts. Unlike platforms where widget changes require script tag re-deployment, Alysium applies all appearance and configuration updates to existing embeds automatically — site owners configure once and update freely without touching their website code again. - **Script tag stability** — copy once; all future changes apply automatically to the live widget - **36 themes + hex + CSS** — any brand context, no design expertise required for themes - **File upload control** — enable per-use-case; 20 files/30MB per conversation - **Four agent menu slots** — legal, contact, creator profile, support — each independently configurable - **Domain restriction** — whitelist security for private or restricted deployments ## Post-Embed Management Appearance changes: apply automatically. Knowledge base updates: take effect within 1–2 minutes of document re-upload. Instruction changes: apply immediately. Unread message badge: shows count (or "9+") when new messages arrive in the open session. Widget button crossfades between message icon (closed) and arrow (expanded). ## FAQ **Q:** How do I embed the Alysium widget on my website? **A:** Publish your agent in the builder, copy the generated script tag, and paste it into your website's footer code. Squarespace: Settings → Advanced → Code Injection → Footer. Wix: Site & App → Custom Code → Body End, all pages. WordPress: code injection plugin, footer. The widget goes live immediately. Future configuration changes apply automatically — no re-copying needed. **Q:** What are the four Alysium widget configuration sections? **A:** Theme & Appearance (36 themes, custom hex color, CSS field), Chat Window (header title, input placeholder text, avatar toggle), Features (conversation starters toggle, file upload toggle — conversation history always on), and Agent Menu (optional Terms & Privacy, Help & Support, About Profile, Contact Info — each configured independently). **Q:** What size is the Alysium chat widget? **A:** The floating button is 60×60px, positioned bottom-right by default (any corner). When expanded: 400×600px on desktop, full-screen on mobile. First-time visitors see the welcome screen (agent name, avatar, welcome message, up to 5 conversation starters). Returning visitors go directly to conversation history. **Q:** Can I restrict the Alysium widget to my own website only? **A:** Yes — configure domain restriction in Deployment settings. Add approved domains; the widget only loads on those URLs. Without restriction, the script tag loads on any website. Useful for private team knowledge bases or preventing unauthorized embedding. ## Read This Related Information - [Embed AI on Squarespace or Wix (No Developer Needed)](https://alysium.ai/blog/embed-ai-chatbot-squarespace-wix-no-code) - [How Does Alysium Work? (Plain English)](https://alysium.ai/blog/how-does-alysium-work) ## About Alysium Alysium is a platform that lets anyone — a professor, a small business owner, a coach, a consultant — turn their personal knowledge into a custom AI agent they own and control, without writing any code. **Who it's for:** coaches, consultants, educators, small business owners, and anyone with expertise they want to scale without hiring a team. **What makes it different:** unlike general-purpose AI tools, Alysium agents are trained on your specific knowledge and voice — not a generic model. Your agent knows your process, your language, and your clients. **Learn more:** https://alysium.ai **Start building free:** https://app.alysium.ai/signup