Using Front Chat


Front Chat is the simplest way for teams to manage live chat in Front. With the Front Chat application installed on your website, messages from your site visitors appear instantly in Front for follow up from your team.

Check out this article once you're ready to create your Front Chat inbox.


Customize your chat widget

Front Chat also allows you to customize your widget with custom colors, logos, header greetings, and website placement. You can also set a team name, configure an automated welcome message to be pushed to every site visitor, and enable email capture with a custom prompt.

Below is a screenshot of various settings. You can edit these at any time in your channel settings for your Front Chat channel.

Manage teammate display name and avatar

By default, each teammate’s name and avatar set in Front will be displayed in chat conversations with customers. If you’d like to customize the name and avatar shown in the chat widget, you have the option to use your team name and company logo instead using the Name and avatar for display setting. This change will be applied for all Front Chat teammates.

This feature is available only on the Scale plan or above.

Set offline hours to hide your chat widget

Front Chat will be always be visible on your website by default. If you'd like to hide your chat application when your team isn't available (such as at night), set your Offline hours in your Front Chat channel settings.

Keep in mind that offline hours hides the widget from view, but does not turn off chat if a customer already has the widget open before your offline hours started, and have not refreshed the page. Customers will still be able to send you messages in the open widget, so best practice is to use an auto-response during your offline hours to set the expectation for when they will receive a response.

Attachments in the chat widget

By default, visitors are allowed to send all supported attachment types in the widget. You can restrict certain file types or prevent visitors from sending attachments altogether.

Collect visitor information in a pre-chat form

You can configure a pre-chat form to collect visitor details at the start of a conversation and build routing, tagging, and assignment workflows for your team. The pre-chat form will appear after any welcome message you’ve added. 

Customize your pre-chat form

By default, your pre-chat form will include email as an optional field for visitors to provide. To further customize your pre-chat form, click Add field to collect additional information (maximum of 3 fields). You can choose to collect existing contact fields, as well as build new contact fields for use within the form. When adding new fields, you can easily rearrange the order of the fields by clicking on the “grab” icon dots to the left of the field name and description.

If you’re creating a custom field for the pre-chat form (e.g., company size or issue type), it will be created as a custom contact field. The pre-chat form currently supports the following field types: Text, Number, Dropdown, Yes or No. Only company admins will have the ability to create custom contact fields for the pre-chat form.

Starter plans will only be able to collect name and email in the pre-chat form. Growth plans and above have the ability to fully customize the fields in the pre-chat form. 

Set optional and required fields

Once you’ve configured the fields you want to collect, you can select which fields you’d like to be optional vs. required. Visitors will need to fill out required fields before starting a conversation, and can choose to supply information for any optional fields configured. In the pre-chat form, visitors will also have the ability to include a message to give your team more context on their issue. Note that if visitor information is already supplied programmatically via the Front Chat SDK, visitors will not be prompted to input that information in the pre-chat form.

Supported visitor response types for the pre-chat form within the widget include text, numbers, customizable dropdowns, and yes/no dropdowns.

If you configure email as an optional field, you’ll also have the ability to prompt visitors to provide their email 10 seconds after a chat is initiated via a banner within the widget. You can customize the message visitors see on this email collection banner.

View pre-chat form information

To properly save the information collected from chat visitors, a contact will be auto-created regardless of what you may have configured in your Automatically create contact company setting.

All information visitors supply in the pre-chat form will be saved to that contact. You can access this information by clicking on a visitor’s name/avatar in the chat conversation, or by viewing the Contact details plugin in your sidebar.

Recognize logged in users

If you are using Front Chat in a web or desktop application and need to identify logged in users, after adding the code snippet you will need to complete an additional step in your setup.

Copy your Verification Secret from your channel settings. This token will be required to create a server-side generated HMAC, which you will use to compute a hash of your users' emails. This hash is what you will have to send to the Front Chat API to authenticate your users — the identity verification will fail unless a user hash is provided. More technical details can be found here.

To reject messages from users not logged in to your site or app, turn on the Only accept messages from logged in users toggle in your channel settings. If you want to accept messages from anonymous visitors browsing your site, do not enable this toggle.

Manage chat conversations across multiple websites

Your custom chat application can be installed on as many pages as you wish, from a same domain. All messages will flow into a single chat inbox, and the conversation will be persistent for the customer across your entire site.

Your sessions will however not be maintained over different domains or subdomains. To share an example:

If you are managing multiple domains or subdomains, you can handle chat conversations separately for each site by creating a separate chat channel for each site.

Customize each application to match each site's branding, install the appropriate scripts, and the chat conversations for each website can be handled in separate inboxes in Front.


Once you set up a Front Chat channel, your team can chat with your website visitors in real-time directly from Front. Use the same rules, analytics, tags, and workflows for Chat that you use for your other channels (email, SMS, Twitter, etc) in Front.

Match visitors with your Front contacts or CRM integrations

If the visitor is logged in and verifies or enters their email in the pre-chat form, Front will search for that email address in your contacts. You can tell if a visitor has submitted their email if this message appears: "User submitted their email:".

If the email address doesn't match an existing contact, a new contact will be created in Front. If the address matches an existing contact, the chat message will be linked to that contact's details. You can view all of their past conversations by viewing the Contact details plugin in your sidebar. 

If you have any integrations enabled that use an email address to identify records, those details will be displayed on the conversation. This applies to Front's CRM integrations: Salesforce, Pipedrive, Base, HubSpot, and Zoho.

If a site visitor does not enter their email address in the pre-chat form or Notify Me prompt, the visitor will be anonymous unless you are using identity verification to pass user names and email addresses.

Transition conversations from chat to email

When a visitor enters their email address in the pre-chat form or Notify Me flow, or has their verified identity set, Front can easily transition the conversation to email if they leave your site without following up.

When a Front user replies to a chat message and the visitor does not respond within 5 minutes, Front will automatically send an email transcript of the last 10 messages to the address the visitor submitted.

You can choose the email address your transcripts are sent from in your channel settings in the Chat Transcript section. It must be sent from a team email channel that you have connected to Front. After setting up email capture in your Front settings, any new visitors to your site or a refresh of your site will get the email option.

When a transcript is emailed to a site visitor, you will see it recorded as an activity within that conversation. The chat transcript email will also be linked to the original chat conversation (and vice versa) so you can easily navigate between the two.

When a site visitor replies to the email transcript, the message will arrive in your chosen shared email inbox in Front. It will not be assigned to anyone, but you can use rules to assign conversations automatically (see below).

Use rules and analytics 

You can use rules and run analytics reports for your Front Chat channel the same way you use them for email, SMS, or other channels in Front.

Here are some example rules for Front Chat to help you get started:

Respond to messages automatically during offline-hours

Assign chats in a round-robin

Assign email follow ups to the user who replied to the chat

For Inbox is, choose the email inbox that your chat transcripts are sent from. For Body Contains, enter the teammate's chat transcript signature. Chat transcript signatures are always "- [User] at Front."

Route chats based on Front Chat visitor URL

Build rules based on information supplied in pre-chat form

Once you’ve configured a pre-chat form with the information you‘d like to collect from visitors, you can build rules to automatically route, tag, and assign these conversations leveraging the custom contact fields in the form. Three popular workflows you can use the pre-chat form for are (1) triaging support inquiries, (2) qualifying sales leads, and (3) routing based on language preferences.

Triaging support inquiries

You can set up your pre-chat form to collect information to identify and triage support inquiries using fields such as (1) Email (2) Are you an existing customer? (3) Issue type (billing, account, cancellation). Then, you can configure rules for these conversations based on the information provided in the custom contact field(s) you created to ensure you’re tagging the conversation correctly and assigning it to the right teammates.

Qualifying sales leads

You can also utilize information collected in the pre-chat form to qualify potential sales leads. For instance, you can configure fields such as (1) Email (2) Company Name (3) Company size (1-10, 11-100, 101-1000, 1000+). Then, you can configure a rule including this custom contact field to route to a specific sales team or sales representative based on information provided. For instance, if it’s a larger prospect, you can tag the conversation with a VIP tag and route it to your enterprise sales team.

Routing based on language preferences

You can use the pre-chat form to identify which language your visitors prefer to converse in using a language custom contact field. Then, you can configure rules to route or assign the conversation to language specialists in your team.

Share content

Customize the feel of your conversations by sharing GIFs, using emojis, or sending files. Both Front users and website visitors can:

  • Send and receive plain text messages and click full URLs
  • Choose attachments (files up to 25mb) and preview images and GIFs. The supported attachment types are .pdf, .png, .jpg, .gif, .txt, .mp4, and .mov.
  • Send shared links to Google Docs or Dropbox files for other content types

Front users have additional formatting options:

  • Bold, italics, and strikethrough
  • Bulleted and numbered lists
  • Embedded hyperlinks
  • Quotes

See what page your visitor is on

Understand where your visitor is on your website. Click the Visitor URL icon on the right side of any message view it. You can also click the link to navigate to the page.

You can also set up rules that automatically tag or route Front chat conversations to specific inboxes based on the URL a Front Chat visitor is initiating a conversation from.

Online and seen indicators

When a visitor has read your message, a Seen indicator will appear. You will also see a green Online indicator if the visitor is currently active.

Typing indicator

You can see when a visitor is typing in the chatbox in real-time. This is what the visitor sees when you add Front Chat to your website:

This is what you'll see when replying to the visitor in Front:

Karen, a teammate in Front, is replying to the visitor (named "Purple Panda") from the Front Chat inbox.

Front Chat notifications

By default, Front Chat notification sounds are distinct from other channel notification sounds to make it easier for your team to identify and prioritize responding to chat messages quickly. You can reference this article to ensure your sound notifications are configured correctly.

The Front Chat sound cannot be customized.


Are there character limits for Front Chat messages?

Yes. Each message has a 2000 character limit. 

Is Front Chat supported on mobile applications?

Yes. You can use a webview to implement Front Chat on mobile applications. You can find more information on this here.

Can I log Front Chat messages into Salesforce?

Yes. You can use Front's rule engine to sync every inbound and outbound chat to Salesforce. The rule would look something like this: WHEN Inbound messages, IF Inbox is [chat inbox], THEN Send as task to Salesforce. In order for this to work, you will need to first have the Salesforce integration enabled in your settings. Salesforce will log the chat messages to the contact with a matching email address, similar to the logging email functionality Salesforce provides.

When is the welcome message displayed?

We will only display the welcome message the first time a visitor loads the widget.

This is related to the PROACTIVE_MSG_USER_COOKIE (appears as fcpmuc in the browser) that gets set the first time the message displays.  If that cookie is present we won't show the message again to avoid a “noisy” experience.

This cookie is set to expire at the end of the session (browser/tab close), so the welcome message will be displayed the next time the site is visited.

If you'd like to override this behavior, your site will need to remove the "fcpmuc" cookie before loading the chat widget.


Front Chat is available on all plans. See additional details about pricing of certain Front Chat features below:

Feature Starter Plan Growth Plan Scale Plan Premier Plan
Rule library templates to create rules for Front Chat inboxes
Custom rules for Front Chat  
Analytics for Front Chat  
Pre-chat form customization beyond name & email fields  
Name and avatar for display feature    

Some legacy plans with different names may also have these features.

31 replies

    • Aaron_Peterson
    • 3 yrs ago
    • Reported - view

    Is there any plan to allow custom contact fields to be sent over in the signed request via

    FrontChat('init', {email: "...", favorite_show: "spongebob", widget_count: 10})


    • Brady_Patrick
    • 3 yrs ago
    • Reported - view

    Aaron Peterson This would be very helpful for us as well. Lemuel Chan can you help us with this one? 

    • Customer Support Representative
    • Lemuel_Chan
    • 3 yrs ago
    • Reported - view

    Brady Patrick Aaron Peterson Thanks for the feedback! This is currently not supported today, however, we have this request in our product backlog and will let you know when this becomes possible in Front!

    • Brady_Patrick
    • 3 yrs ago
    • Reported - view

    Lemuel Chan Appreciate it. Hoping to see some Front Chat improvements this year.

    • Aaron_Peterson
    • 3 yrs ago
    • Reported - view

    This year come on this week! Front is awesome. Please save us from Intercom.

    • Zaldy_Gonzales
    • 2 yrs ago
    • Reported - view

    Hello, how can I place the chatbox in the lower-left corner instead or the right side corner? Also how to install it in Bootstrap Studio as global header?