How 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.
Update the avatar from the right place
Make sure you changed your account avatar, not the workspace icon. The workspace icon is used for different branding surfaces and does not replacРедко просматриваютHow 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.
Check how Crisp decides who to notify
Crisp avoids flooding every teammate at once. Notifications are sent based on conversation state, assignment, operator availability, andРедко просматриваютHow 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.
Check the domain lock option
Crisp includes a security option that locks the chatbox to your configured website domain and subdomains. If this option is enabled, other domains cannot load the same chatbРедко просматриваютHow 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.
Understand the errors
You may see one of these messages when creating an account or workspace:
Common error messages:
**`**You have been forbidden to crРедко просматриваютHow 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.
Live chat is not displayed on Shopify
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.
Save the theme modification
WhenРедко просматривают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.
Check firewall or proxy blocking
SРедко просматриваютHow 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.
Check visitor privacy settings
Crisp respects visitor privacy choices. If the visitor enabled Do Not Track in their brРедко просматриваютHow 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Редко просматриваютHow 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.
Check Do Not Track settings
Crisp respects the Do Not Track browser signal. If the visitor enabled Do Not Track, Crisp disables MagicType for that visitor to respect their privacy chРедко просматривают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.
Custom knowledge base domain is rejected
When you configure a custom knowledge base domain, Crisp provides DNS records that must be added to your domaiРедко просматриваютHow 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.
||| The Crisp chatbox is compatible with ****Редко просматриваютHow 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Редко просматривают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.
Check the chatbox installation code
First, confirm that the Crisp script is present on the page where you expect thРедко просматриваютHow 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.
Connection redirects to an error page
In some cases, the Meta connection popup lets you create or select a business, verify the phone number, and then redirects back to an error page in CrispРедко просматриваютWhat 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
LiveTranslate quotas apply per workspace and are shared by all operators using the feature.
__CurРедко просматривают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.
Check spam and mailbox filtering
Email providers can incorrectly classify Crisp emails as spam, especially when many notifications are sent over time.Редко просматриваютHow is Crisp optimised to not slow down your website's loading
Understand how the Crisp chatbox is optimized for website performance and what to check when automated tools report warnings.
Crisp is built to load asynchronously and keep the chatbox lightweight. Automated performance tools can still report warnings because they do not always account for compression, caching, HTTP/2, delayed loading, and user experience context.
How Crisp loads on your website
The Crisp chatbox is designed to avoid blocking your main page content. It loads asynchРедко просматриваютHow 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Редко просматриваютHow 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.
Browser sound limitations
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.
__Example scenarioРедко просматривают