Troubleshooting Chatbox issues
How to troubleshoot chatbox visibility issues
Troubleshoot the most common reasons the Crisp chatbox does not appear or work correctly on your website. When the chatbox is missing, the cause is usually the installation code, browser compatibility, cached assets, a JavaScript conflict, a security rule, or a Crisp setting that hides the widget. Start with the checks below before investigating deeper network issues. First, confirm that the Crisp script is present on the page whPopularHow to troubleshoot "Invalid website" errors in the chatbox
Fix “invalid chatbox code” or “Invalid Website” errors by checking your domain lock, installation code, and workspace state. These errors usually come from a mismatch between the installed chatbox code, the domain allowed to load it, and the Crisp workspace that owns the Website ID. Crisp includes a security option that locks the chatbox to your configured website domain and subdomains. If this option is enabled, other domains cannot loFew readersHow to troubleshoot encoding issues in the chatbox
Fix broken accents, question marks, symbols, or incorrectly displayed characters in the Crisp chatbox by using UTF-8 encoding on your website. The Crisp chatbox supports international languages, accents, non-Latin alphabets, and emojis through UTF-8. Because the chatbox is injected into your website page, it can inherit the page encoding; if your website still uses a legacy charset, characters inside the chatbox may display incorrectly.Few readersHow does the Crisp chatbox handle high website traffic
Understand how the Crisp chatbox behaves on high-traffic websites and what changes when traffic reaches safety thresholds. The Crisp chatbox is designed to scale on busy websites. At high volume, Crisp can adjust some real-time behaviors to protect performance while keeping visitor messaging available. In this article: How high-traffic mode works → what changes for visitors and operators High-traffic thresholds → when CrFew readers
Fixing Crisp App issues
How to troubleshoot operator network connectivity issues
Troubleshoot real-time message delivery issues in the Crisp dashboard. Crisp uses WebSockets to deliver new messages and live updates to your dashboard. If the real-time connection is blocked or unstable, Crisp may show an orange warning banner and messages may only appear after refreshing. Real-time connection warning banner (https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/cleanshot-2025-02-27-at-1136541c5oyh4.png =1000xauto) color 0080dd (Check firewall orPopularHow to troubleshoot operator push notifications issues
Troubleshoot Crisp notification issues across email, browser, desktop, and mobile apps. Most notification problems come from conversation state, assignment rules, local app permissions, browser focus, battery-saving settings, or stale cache. Check each layer below before assuming the notification was not sent. Crisp avoids flooding every teammate at once. Notifications are sent based on conversation state, assignment, operatorSome readersHow to troubleshoot MagicBrowse issues
Troubleshoot the most common reasons MagicBrowse cannot start or render a visitor page correctly. MagicBrowse depends on the visitor session, your website assets, and the network path between Crisp, your website, and the visitor browser. Most issues come from privacy settings, local environments, restrictive security rules, or blocked WebSocket connections. Crisp respects visitor privacy choices. If the visitor enabled *Do Not TrackFew readersHow to troubleshoot sound push notification issues
Understand why sound notifications may not play for new Crisp messages and what alternatives to enable. Most sound issues are caused by browser behavior rather than Crisp. Modern browsers often mute hidden tabs after a few minutes to save battery and prevent unwanted sounds. Browsers such as Chrome, Safari, and Firefox can mute tabs that are hidden or inactive. This can prevent a sound from playing even when a new Crisp message arrives.Few readersWhat happens when my LiveTranslate weekly quota is reached
Understand what happens when your workspace reaches a LiveTranslate quota and how to request higher limits. LiveTranslate quotas protect the service from abuse while keeping translation usage predictable across busy inboxes. If a quota is reached, new translation requests are temporarily rejected until capacity becomes available again or your limits are increased. LiveTranslate quotas apply per workspace and are shared by all operators using thFew readersHow to troubleshoot account and workspace creation issues
Troubleshoot errors that prevent you from creating a Crisp account, creating a workspace, or adding a new workspace. Account and workspace creation can be blocked by regional availability, abuse-prevention checks, VPN usage, or network reputation. The checks below help you retry from a clean setup before contacting support. You may see one of these messages when creating an account or workspace: Common error messages: You have been fFew readersHow to troubleshoot MagicType issues
Troubleshoot cases where MagicType does not show what a visitor is typing before they send a message. MagicType depends on visitor privacy settings, network quality, and enough typed content to stream a useful preview. If one of those conditions is not met, the typing preview may stay disabled. Crisp respects the Do Not Track browser signal. If the visitor enabled Do Not Track, Crisp disables MagicType for that visitor to respect theFew readersHow to troubleshoot operator avatars not uploading
Fix cases where your Crisp profile picture does not appear updated in the chatbox or previous messages. Avatar updates can look delayed because Crisp distinguishes your personal profile picture from the workspace icon, and previously sent messages keep the avatar they had when they were sent. Make sure you changed your account avatar, not the workspace icon. The workspace icon is used for different branding surfaces and doFew readers
Troubleshooting issues with emails
How to troubleshoot outbound email issues (users not receiving emails sent from Crisp)
Troubleshoot missing emails sent by Crisp, including operator notifications, login emails, invitations, and verification messages. This article covers emails Crisp sends to you. If customers are sending emails to your Crisp Inbox and those emails are not received, use the inbound email troubleshooting guide instead. Email providers can incorrectly classify Crisp emails as spam, especially when many notifications are sent oveFew readersHow to troubleshoot inbound email issues (emails sent by users not received in Crisp)
Troubleshoot inbound emails that do not appear in your Crisp Inbox and understand why some messages may be rejected before they reach your team. Inbound email delivery depends on your Crisp email settings, custom domain DNS records, sender authentication, and Crisp anti-spam protection. Start with the checks below, then use any bounce or SMTP error returned to the sender to identify the exact cause. In this article: Check whether the email was filtered as spam (1-check-whether-the-emFew readersHow to improve email deliverability
Improve outbound email deliverability for messages sent from Crisp, including replies, campaigns, and automated emails. Deliverability depends on sender authentication, domain reputation, recipient engagement, bounce handling, and sending volume. Crisp provides tools such as custom email domains, custom SMTP, and email reputation pools, but good sending practices still matter. In this article: Use Crisp deliverability tools → custom domains, SMTP, rFew readers
Issues with other Crisp features
How to troubleshoot Knowledge Base issues
Troubleshoot common Crisp knowledge base issues, including custom domains, article visibility, cache, SSL, and error pages. Most knowledge base issues come from DNS configuration, category visibility, short cache delays, or SSL provisioning after a custom domain change. Use the sections below to identify which layer needs attention. When you configure a custom knowledge base domain, Crisp provides DNS records that must be adFew readersHow to troubleshoot WhatsApp integration issues
Troubleshoot common blockers when connecting or using WhatsApp Business Platform with Crisp. Most WhatsApp issues are linked to the Meta connection flow, phone number eligibility, message templates, number migration, or phone number formatting. Use the sections below before contacting support. In some cases, the Meta connection popup lets you create or select a business, verify the phone number, and then redirects back to an erFew readersHow to troubleshoot Shopify integration issues
Troubleshoot common issues with the Crisp Shopify integration and live chat display. Most Shopify issues come from theme changes that were not saved or from an app authorization that needs to be refreshed after new Shopify permissions were added. The Crisp Shopify app can add the live chat to your online store, but the widget will not appear if the theme modification was enabled without saving the change. color 445055Few readers