---
title: "FreeScout"
category: "Business operations"
tagline: "A shared help desk inbox so your team can answer customer email together."
replaces: ["Zendesk", "Help Scout", "Freshdesk", "Front"]
address: "freescout.example.com"
website: "https://freescout.net/"
upstreamDocs: "https://github.com/freescout-help-desk/freescout/wiki"
links:
  - name: "FreeScout wiki"
    url: "https://github.com/freescout-help-desk/freescout/wiki"
  - name: "FreeScout modules"
    url: "https://freescout.net/modules/"
  - name: "FreeScout FAQ"
    url: "https://github.com/freescout-help-desk/freescout/wiki/FAQ"
---

## Overview

FreeScout turns a support address like `support@example.com` into a shared inbox. Every incoming email becomes a **conversation** that can be assigned, discussed internally, and tracked until it's resolved, so nothing falls through the cracks and customers get one consistent reply.

Main capabilities:

- **Mailboxes** connected to your support addresses.
- **Assignment**, **statuses** (Active, Pending, Closed, Spam), and **follow** to stay informed.
- **Internal notes** visible only to your team, with @mentions.
- **Saved replies** for common answers.
- **Collision detection** so two people don't answer the same email.
- **Customer profiles** with conversation history.
- **Auto-replies**, signatures per mailbox, and notification settings per person.
- **Modules** (some free, some paid) for knowledge bases, satisfaction ratings, live chat, reports, and more.

### What it replaces

FreeScout replaces email-based help desks such as Help Scout, Zendesk, Freshdesk, and Front for teams that support customers mainly over email.

## Signing in

Open your FreeScout address and sign in with the account your administrator created. FreeScout keeps its own user list; ask an administrator to add you to the right mailboxes.

## Handle conversations

1. Open a mailbox from the top menu. Folders on the left show **Unassigned**, **Mine**, **Assigned**, **Closed**, and **Spam**.

   {{< screenshot src="freescout/conversations.png" alt="FreeScout mailbox showing the Assigned folder with a list of conversations" caption="A mailbox, with folders on the left and conversations on the right." demo="true" >}}

2. Open a conversation and **assign** it to yourself (or a colleague) from the toolbar.
3. Choose **Reply** to answer the customer, or **Note** to leave an internal comment.
4. Set the status when you send:
   - **Active** while you're working on it.
   - **Pending** when you're waiting for the customer. It returns to Active when they reply.
   - **Closed** when it's resolved.

   {{< screenshot src="freescout/reply.png" alt="Replying to a conversation in FreeScout, with the Status and Assign to menus under the editor" caption="Replying to a customer. The **Status** and **Assign to** menus sit under the editor." demo="true" >}}

Use **Saved replies** (the speech-bubble icon in the editor) for answers you send often, and **Merge** if a customer starts several conversations about the same thing.

## Notifications

Under your avatar, **Your profile**, **Notifications**, choose which events email you or show in the browser: new conversations, replies to your conversations, mentions, and more.

## Set up a mailbox (administrators)

1. Go to **Manage**, **Mailboxes**, **New mailbox**. Enter the name and support email address.
2. Open **Connection settings**:
   - **Sending emails**: choose SMTP and enter your outgoing mail server details.
   - **Fetching emails**: enter the IMAP details for the mailbox so FreeScout can collect new messages.

   {{< screenshot src="freescout/connection-incoming.png" alt="The Fetching Emails tab of a FreeScout mailbox's connection settings" caption="**Connection settings**, **Fetching emails**: the IMAP server, port, username, and password for the mailbox." demo="true" >}}

3. Under **Permissions**, choose which users can access the mailbox.
4. Set the mailbox **signature** and an **auto reply** acknowledging new requests.

If your support address is hosted on Federated Core's mail server, get the IMAP and SMTP details from Superpanel. Create a dedicated mailbox for FreeScout rather than using a person's own mailbox.

## Administer FreeScout

Open **Manage**:

- **Users**: invite agents and set their role (User or Administrator).
- **Settings**: company name, logo, time format, and mail settings for system notifications.
- **Modules**: install and activate modules. Paid modules require a licence key from FreeScout.

## Superpanel settings

{{< review "confirm Superpanel option names for FreeScout." >}}

- **Access**: choose which groups are given the FreeScout address.
- **Mailboxes**: create the shared support mailbox in Superpanel, then connect it in FreeScout.

Fetching email depends on a scheduled task that Federated Computer runs. If new emails stop appearing, check **Manage**, **System**, **Status**, then contact support.