> For the complete documentation index, see [llms.txt](https://docs.clearfeed.ai/clearfeed-help-center/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clearfeed.ai/clearfeed-help-center/account-setup/whitelabel-clearfeed.md).

# Whitelabel ClearFeed

You can white-label ClearFeed to enhance your brand visibility on Slack. This feature allows you to replace the ClearFeed app's name and logo with your own, ensuring a consistent brand experience for customers and employees.

{% hint style="info" %}
If Child Accounts share the same Slack workspace with your Primary Account, then the white-label configuration of the Parent Account will be inherited.
{% endhint %}

## **How to White-label ClearFeed?**

1. From the left-nav bar, go to Settings -> [Additional Settings](https://web.clearfeed.app/settings/additional-settings)
2. Under the `White-label ClearFeed` section, you will see an option to `Edit`.
3. Enter a new `Display Name`.
4. Under the `Profile Photo` section, enter the exact URL of the image.
5. Click on **Save**, and the selected image will appear in the display window.

### Image Guidelines

* Support image extensions: .png, .jpeg, .jpg.
* To upload the image, first host it publicly.
  * **Free option:** Use [Postimages.org](https://postimages.org/) — a simple, free service for hosting images publicly. Just upload your image and copy the direct URL to use here.
  * **Alternative:** Use an S3 bucket or any public image hosting service.
  * Google Drive URLs for images are not supported.
  * If images are hosted on a public site, ensure you verify their expiration dates as the URLs may become invalid afterwards.
* Ensure the image URL ends with a proper image file extension. (e.g. <https://www.example.com/image.png>).

### Examples

Once you complete the above process to white-label the ClearFeed app, the updated name and logo will be visible in the below-mentioned scenarios:

1. Messages sent by ClearFeed workflows
2. ClearFeed's GPT-Powered automated answers shared on Slack
3. Ticket details shared on the request channel thread
4. Other ephemeral messages shared by ClearFeed when a user files a ticket or is auto-assigned a request

## **White-labeling for multiple accounts**

* If you have created child accounts that share the same Slack workspace, the white-labeling settings will be available in the parent account itself and the child accounts will inherit these settings.
* If the child accounts share a different Slack workspace, then each of these accounts can have a separate white-labeling configuration which can be enabled by reaching out to the ClearFeed team via Slack or on <_support@clearfeed.ai>.\_

## **Renaming the ClearFeed Bot**

While white-labeling allows users to see a different bot name and logo when ClearFeed posts messages as a bot, if they want to tag the bot - they still need to tag `@ClearFeed`. Slack administrators can rename the ClearFeed bot in their workspace so users can tag a different bot name instead. This is a good complement to white-labeling - allowing personalization for commands where bot tagging is required.

**Note:** Renaming the ClearFeed bot is a Slack workspace-level operation. If you have multiple ClearFeed accounts attached to the same Slack workspace, the renamed bot will apply to all of them.

### How to rename the ClearFeed Bot

1. Visit the Slack admin page: <https://slack.com/signin?redir=%2Fadmin#/signin>
2. Open your workspace from this page (if multiple workspaces are shown)
3. From the Left Nav - open `Integrations` and then click on `Manage Integrations`
4. This takes you to the "Installed Apps" page where you can see all the Apps installed in your Slack workspace.
5. Find the `ClearFeed` app - and click on the `...` next to it and click on the `View in Slack Marketplace Link`

<figure><img src="/files/RIyOmEdyg4Q089yppuoq" alt="" width="563"><figcaption><p>Click on "..." next to ClearFeed and select "View in Slack Marketplace Link"</p></figcaption></figure>

6. This would take you to a link that looks like `https://<your_workspace_name>.slack.com/marketplace/A02RHUFQ2UR-clearfeed`
7. Find the "Bot User" section, click the Edit button and enter a new name for the Bot.

<figure><img src="/files/4FdXvr36SiDrUeQIXRgt" alt="" width="563"><figcaption><p>Edit the Bot User name in the "Bot User" section</p></figcaption></figure>

After this step - users can tag or use the new bot name - instead of `@ClearFeed` - where bot tagging is required (for example to create tickets or invoke AI Agents using Bot Tagging or when inviting the bot to channels using Slack commands (`/invite`)). The new bot name is also visible in the list of integrations in a request channel (i.e. on customer channels - customers see the new bot name as being the app installed in the channel).

{% hint style="warning" %}
**Important:** The ClearFeed bot image cannot be updated in this manner - only the name can be edited. To customize both the bot name and logo, use the white-labeling feature described above.
{% endhint %}

## Visibility

ClearFeed's icon will continue to appear in a few places even after white-labeling. These scenarios include:

* **Collapsed message threads in Slack:** Whenever you are viewing a collapsed message thread in Slack, messages synced from external ticketing systems or other channels (via ClearFeed) will still display the ClearFeed icon, as shown below:\\

  <figure><img src="/files/tYhxPmERFOA1MUzxOVlB" alt="" width="563"><figcaption></figcaption></figure>
* **Sender profile on synced messages:** For example, in a triage channel, if you hover over the profile of someone whose reply was synced from the request channel, the ClearFeed app icon will appear instead of your white-labeled icon.\\

  <figure><img src="/files/FzxvEAmrDjpr0ThFFyDS" alt="" width="381"><figcaption></figcaption></figure>
* **Adding ClearFeed to a channel:** Using `/invite @clearfeed` will always show the ClearFeed app icon rather than the white-labeled one.
* **Messages with attachments:** Due to Slack API limitations, ClearFeed cannot impersonate users when posting messages with attachments. This affects workflows involving attachments, such as replying with attachments or posting announcements with attachments. In these cases, messages will be posted as the ClearFeed bot itself rather than using your white-labeled name and icon.

To display your custom icon across all relevant surfaces, you can use a Custom App setup. Enabling it requires backend configuration by the ClearFeed team along with a few steps on your end. To get started, reach out to our support team via your Slack Connect channel or email <support@clearfeed.ai>

White-labeling for the Microsoft Teams app is also supported through a Custom App setup. If you'd like to enable this, please contact our support team through Slack Connect or at <support@clearfeed.ai>

{% hint style="danger" %}

### Custom App Setup Limitations

When you move from the standard ClearFeed app to a Custom App setup, Slack and MS Teams treats the new custom app as a completely separate application. As a result:

* The new custom app **cannot edit or delete** messages that were originally sent by the old ClearFeed app (including triage messages and messages synced between request and triage channels).
* Only messages sent by the new custom app (after it is installed) or by human users themselves can be edited or deleted going forward.

This behavior is enforced by Slack & MS Teams and applies to all apps: one app cannot manage messages created by a different app.
{% endhint %}