Announcing embedded mode for the Web Widget

<figure class="wysiwyg-table" style="width: 100%;"><table class="wysiwyg-table-resized" style="margin-left: 0px; margin-right: auto;">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<tbody>
<tr>
<td>Announced on</td>
<td>Rollout on</td>
</tr>
<tr>
<td>December 11, 2025</td>
<td>December 11, 2025</td>
</tr>
</tbody>
</table></figure><p>Zendesk is excited to introduce embedded mode for the Zendesk Web Widget. This new feature lets developers embed the widget directly inside custom containers on any web page, positioning conversational modules precisely where your customers need them most. With embedded mode, you can easily integrate Zendesk’s conversational features into your site’s layout, all while retaining the full functionality of the traditional Web Widget and customizing its appearance to match your brand.</p><p>This announcement includes the following topics:</p><ul>
<li data-list-item-id="e58023a9a0e593a1188d44b5e7d50ba50"><a href="#h_01KC6GS5P3YS30BTWSQG7YFHGH">What is changing?</a></li>
<li data-list-item-id="e9d3d7adcc7d1bcd53a74a9c9ca4e7681"><a href="#h_01KC6GS5P721Q8F1ZB6VQ7VJ5V">Why is Zendesk making this change?</a></li>
<li data-list-item-id="e116f289f6b78725c95e26a60fcd1be78"><a href="#h_01KC6GS5P8Q2TKYA3H1GP6P6MB">What do I need to do?</a></li>
</ul><h2 id="h_01KC6GS5P3YS30BTWSQG7YFHGH">What is changing?</h2><p>Embedded mode gives you greater flexibility in how you use the Zendesk Web Widget, allowing you to embed the full widget or individual components directly into your website’s layout. This makes it easier to match the widget experience to your site’s structure and user journey. Some of the key use cases include:</p><ul>
<li data-list-item-id="ef8f3679dca69dd2c9df267080b622897">
<strong>Embedded Widget Mode</strong>: Embed the entire Zendesk Web Widget inside any HTML container on your homepage, support center, or custom modules.</li>
<li data-list-item-id="ee56a9c7c39644e58258aaecf9512489f">
<strong>Composable Sub-Views</strong>: Place core components like conversation list, conversation screen, new conversation button in separate containers to create a tailored conversational flow.</li>
<li data-list-item-id="eada4b7e968dae57ce7cf0d49d236ecd4">
<strong>Responsive &amp; Adaptive UI</strong>: Ensure components resize and realign automatically, adapting your site’s spacing and theming for seamless integration.</li>
<li data-list-item-id="e93a69f25ad256454a111f3f89856742a">
<strong>In-Sync Modules</strong>: Link embedded modules so that actions in one (e.g., selecting a conversation from the list) instantly update the others (e.g., the selected conversation is immediately displayed on the screen).</li>
<li data-list-item-id="e7923b5f08f9eef3689c741852b6f7cf5">
<strong>Fullscreen &amp; Navigation</strong>: Allow smooth transitions between embedded regions and fullscreen takeover, with navigation controls styled to fit your container.</li>
<li data-list-item-id="ea263c2d7a3e3b85725655d2a8dc39aa3">
<strong>Theming &amp; Customization</strong>: Preserve all your current widget customizations for consistent branding in embedded mode. For more information, see <a href="https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/web/client-color/" target="_blank" rel="noopener noreferrer"><span class="wysiwyg-underline">Customizing Web Widget colors</span></a> in our developer documentation.</li>
</ul><h2 id="h_01KC6GS5P721Q8F1ZB6VQ7VJ5V">Why is Zendesk making this change?</h2><p>Organizations increasingly require more layout flexibility than traditional floating chat bubbles offer. Modern Help Centers, marketplaces, and support portals benefit from:</p><ul>
<li data-list-item-id="e0acda5c4f645c0c46e1d29484a81979b">Custom-built homepages displaying conversations, guides, alerts, and booking tools side-by-side.</li>
<li data-list-item-id="e3511576076a601f7fbafe6c162f5ac3c">Native site UI integration for a seamless, branded experience.</li>
<li data-list-item-id="eb58c28d8180cfe064a84a60b0b432b29">Enhanced control over layout and entry points for chat and self-service options.</li>
</ul><h2 id="h_01KC6GS5P8Q2TKYA3H1GP6P6MB">What do I need to do?</h2><p>This functionality is available to all accounts with Messaging enabled but does require some developer involvement. See <a href="https://developer.zendesk.com/documentation/zendesk-web-widget-sdks/sdks/web/embedded-mode/">Web Widget embedded mode</a> in our developer documentation to learn how to implement embedded mode and <a href="https://internalnote.com/embeddable-zendesk-widget/#embedded-the-widget-in-some-actual-websites" target="_blank" rel="noopener noreferrer">explore demo examples</a>.</p><p>If you have feedback or questions related to this announcement, visit our <a href="https://support.zendesk.com/hc/en-us/community/topics/1260801308710-Feedback-Chat-and-Messaging-Chat-" target="_blank" rel="noopener noreferrer">community forum</a> where we collect and manage customer product feedback. For general assistance with your Zendesk products, contact <a href="https://support.zendesk.com/hc/en-us/articles/4408843597850" target="_blank" rel="noopener noreferrer">Zendesk Customer Support</a>.</p>