Ferndesk
3rd-party chat widgets

Setting up Plain with Ferndesk

This guide shows you how to configure Ferndesk to open Plain when visitors click the contact button in your widget.

Before you begin: You must have Plain installed on your site with the launcher disabled. If you haven't done this yet, follow the steps below before configuring Ferndesk.

Step 1: Install and hide the Plain launcher

First, make sure Plain is installed on your site. You'll need to disable the default Plain launcher so it doesn't show alongside your Ferndesk widget.

Add hideLauncher: true to your Plain initialization:

Plain.init({
  appId: 'YOUR_CHAT_APP_ID',
  hideLauncher: true,
});

This hides the Plain launcher by default. Ferndesk will show it when visitors click your contact button.

Need help installing Plain? See Plain's documentation.

Step 2: Open widget settings

In your Ferndesk dashboard, go to the Widget page and click the Customize button on your widget.

Step 3: Navigate to Contact settings

In the sidebar, click Contact to open the contact configuration options.

Step 4: Select the Integration tab

Click the Integration tab to see available chat platforms.

Step 5: Choose Plain

Click the Plain card to select it as your integration platform.

Step 6: Test the integration

Visit your site where the Ferndesk widget and Plain are installed, then click the contact button in the widget. The Plain chat should open, letting visitors start a conversation with your team.

If Plain doesn't open, verify that Plain is installed on the same page as your Ferndesk widget and that you enabled hideLauncher: true.

Was this helpful?