Skip to main content

Add a Support Chat Widget to Your Pages

Written by Harneet Kaur

Plans: Premium, Enterprise
​Platforms: All platforms
​Applies to: Tracking and returns pages

Overview

The Support chat widget adds a chat button that floats on top of your tracking or returns page, in the bottom corner you choose, so shoppers can reach a live support agent or your help page without leaving the page.

Learn how to add a support chat widget to your pages in AfterShip. This guide walks you through adding the widget in the page editor and setting up one of three chat types: a chat page link, the Zendesk Web Widget, or the Gorgias Chat widget. Once live, shoppers get faster answers while they track an order or request a return, which reduces support calls and improves customer satisfaction.

Before You Begin

Requirements

  • A tracking page or returns page in Branded pages

  • For the Chat page option: a valid URL for your chat page, Q&A page, contact page, or FAQ section

  • For the Zendesk Web Widget option: a Zendesk account with a messaging Web Widget or Web Widget (Classic)

  • For the Gorgias Chat widget option: a Gorgias account with a chat channel

Limitations

  • Warranty pages don't support the Support chat widget

Step 1: Add the Support Chat Widget

Add the widget from the page editor's Widgets tab. The widget settings open on the right once you add it.

  1. Go to Branded pages and open your page in the editor.

  2. In the left panel, click the Widgets tab.

  3. Click Add widget > Support chat.

The Widgets tab with the Add widget menu

Support chat widget settings with Chat type set to Chat page

Step 2: Set Up Your Chat Type

Choose how shoppers reach you from the chat button. The editor supports three Chat type options: Chat page, Zendesk Web Widget, and Gorgias Chat widget.

Option A: Link a webpage to the chat button

The Chat page option links the chat button to your website's chat page, Q&A page, contact page, or FAQ section, so shoppers can self-serve or reach out to you.

  1. Enter the Chat page URL you want to send shoppers to for assistance.

  2. (Optional) Edit the Button text that appears on the chat button.

  3. Upload an Icon for the chat button. AfterShip provides a default icon that you can replace or remove.

  4. Choose the Position of the chat button on the page.

  5. Click Save.

Important: The chat button only appears on your page when you enter a valid chat page URL.

Option B: Install the Zendesk Web Widget

The Zendesk Web Widget option installs Zendesk's messaging web widget on your page, so shoppers can connect with a live support agent the moment they need help. AfterShip supports Zendesk's messaging Web Widget and Web Widget (Classic).

  1. Select Zendesk Web Widget as the Chat type.

  2. Paste the Zendesk Web Widget code from your Zendesk account into the field.

To find the messaging Web Widget code:

  1. In the Zendesk Admin Center, click Channels in the sidebar, then Messaging and social > Messaging.

  2. Select the existing widget to install, or click Add channels to create a new one.
    ​

  3. Scroll to the Installation tab and click Copy code at the bottom of the code snippet.

  4. In the Style tab, customize the style of the button and header to match your page.

  5. Paste the copied code into the Widget code field in the AfterShip editor.

    Find more instructions here.

To find the Web Widget (Classic) code:

  1. In the Zendesk Admin Center, click the Channels icon in the sidebar, then Classic > Web Widget.

  2. Click the Setup tab if it isn't already selected.

  3. Under the code box, click Copy to clipboard.

  4. Configure the components of Web Widget (Classic) as needed: help center search and suggested articles, Zendesk Chat for live chat, Zendesk Talk for callbacks or a phone number, contact forms for filing a ticket, and style (theme color, text color, button text, and so on).
    ​

    Find more instructions here.

Option C: Install the Gorgias Chat widget

Before you start, make sure you’ve connected a store to Gorgias if you plan to install the chat widget on an ecommerce platform. This isn’t required if you’re installing chat on another type of website.

The Gorgias Chat widget option installs your Gorgias chat on your page.

  1. Select Gorgias Chat widget as the Chat type.

  2. Paste the Gorgias Chat Widget code from your Gorgias account into the field.

To find the Gorgias Chat widget code:

  1. From your helpdesk, click the  Settings icon in the bottom-left corner.

  2. In the sidebar, locate Channels, then select Chat.

  3. Click + New chat in the top-right corner.

  4. Under Chat title, give your chat a name.
    ​

  5. Click the dropdown menu under Default language, then select a language. To make chat available in additional languages, click + Add language.

  6. Under Choose where you’ll install your chat, select either Ecommerce platforms or Any other website.

  7. Under Connect a store, click the drop-down menu, then select a store. Skip this step if you chose Any other website in the previous step.

  8. Under Choose how to connect with customers, select either Allow live chat messages to enable real-time chat messaging, or Allow only offline capture messages if customers should only be able to open an asynchronous email ticket from the chat widget.

  9. Click Continue.

  10. Move to the Installation tab and select Install Manually as your Installation method. Click Install manually again from the bottom of the page.

  11. Scroll down to Advanced installation > Install with code.

  12. Click Shopify website for a Shopify store, or Any other websites for other stores.

  13. Click Copy code from the bottom of the page.

14. Paste the copied code into the Widget code field in the AfterShip editor.
​

In Gorgias, you can then customize the

  • Appearance of the button and header to match your page: edit the chat title and language, pick the main color, conversation color, and font, upload your company logo, position the chat widget on the page, and choose the avatar for support agents.

  • Under Preferences, you can hide the chat outside business hours, configure an auto-responder, and pick the associated email integration.

What Your Shoppers Will Experience

After completing these steps:

  • Shoppers see the chat button floating on top of your page, in the bottom corner you chose.

  • Shoppers reach a live support agent or your help page without leaving the page.

  • On tracking pages, shoppers whose orders show Exception or Failed attempt statuses can contact you at the moments they most want to talk to someone.

  • On returns pages, shoppers stuck mid-return can ask a question and resolve it without leaving the returns flow.

Troubleshooting

Problem

Cause

Solution

The chat button doesn't show on my page (Chat page)

The Chat page URL field is empty or the URL isn't valid

Enter a valid chat page URL and click Save.

The chat widget doesn't show after I add the Zendesk or Gorgias code

  • Visibility is restricted in your Zendesk or Gorgias admin: Gorgias visibility is set to Hide chat or Hide outside of business hours, or your Zendesk web widget Schedules limit the active hours.

  • AfterShip doesn't display the chat button in the editor, in preview, or on the live page during those times.

Check the visibility and schedule settings in Zendesk or Gorgias.

The chat widget doesn't show after I add the Zendesk or Gorgias code

You enabled an allowlist but didn't include AfterShip's site

Add AfterShip's domain to the allowlist.

Zendesk schedule settings

Gorgias visibility settings

Allowlist

FAQs

1. Why aren't the chat button preferences I set in Zendesk or Gorgias showing on my page?

Changes in Zendesk or Gorgias take around 10–20 minutes to sync to your page.

2. Does the chat widget work in preview?

Test it on the live page, not only in preview. Chat widgets are the most common thing to work in the editor but not on the published page, usually because of the provider's own domain or visibility settings.

3. Can I add a support chat widget to warranty pages?

No. Warranty pages don't support the Support chat widget. You can add it to tracking and returns pages.

Key Takeaways

  • The Support chat widget connects shoppers with a live agent or your help page from a floating button.

  • Add it from the editor's Widgets tab (not Sections), then pick Chat page, Zendesk Web Widget, or Gorgias Chat widget.

  • Tracking and returns pages support the widget; warranty pages don't.

  • Style and preference changes in Zendesk or Gorgias take 10–20 minutes to appear on your page.

  • Provider visibility settings, schedules, or an allowlist missing AfterShip's domain can hide the widget.

Did this answer your question?