---
title: "Set your organization name, logo, and handle"
description: "How an IoTFlows organization appears to its members and to anyone they chat with. The logo, name, description, and handle all live in the Organization section at /settings/organization, behind an Edit button, and save together with Save. The logo is the exception: it opens a crop dialog and uploads on its own. The handle is the unique short name for the organization and the second half of every member's chat address, in the form username:orghandle. The field accepts lowercase letters, digits, and underscores, and checks availability half a second after you stop typing, but nothing blocks Save on a taken handle. Changing the handle rewrites every member and team chat address, so people outside the organization who saved the old one can no longer find you."
category: "Organization settings"
source_url: "https://www.iotflows.com/docs/admin/org-profile/"
---
# Set your organization name, logo, and handle

How your organization appears to your members, and to anyone you chat with.

The *organization profile* is the four fields that identify your company across IoTFlows: a logo, a name, a description, and a *handle*, the unique short name other organizations use to reach your people in chat. All four sit in the **Organization** section at the top of Organization Settings, at `/settings/organization`. [Shifts and the organization timezone](/docs/admin/shifts-and-timezone/) are on the same screen, further down.

**Before you start.** You need to be an *Organization Owner* or an *Organization Administrator*. See [Roles and permissions](/docs/admin/roles-reference/).

The section is read-only until you select **Edit** at its top right. **Edit** unlocks the name, description, and handle together, and one **Save** commits all three. The logo is the exception: it opens its own dialog and uploads on its own.

## Upload a logo
1. Select **Edit** at the top right of the **Organization** section. The logo tile does nothing until you do.
2. Select the logo tile. Your file picker opens.
3. Choose an image. IoTFlows takes any format the browser reads, plus `.heic` and `.heif` from an iPhone, which it converts to JPEG first.
4. Drag the image inside the crop frame, and set the **Zoom** and **Rotation** sliders until the square holds what you want.
5. Select **Preview**. To change the crop, select **Back**.
6. Select **Submit**. An "Organization logo updated" toast confirms the upload and the dialog closes.

IoTFlows crops to the square you set and compresses the result to WebP at around 500 KB, so a 12 MB photo straight off a phone is fine.

![The Organization section of Organization Settings in edit mode, with Cancel and Save at the top right in place of Edit. Callout 1 marks the square organization logo tile, callout 2 marks the Organization name field reading IoTFlows, and callout 3 marks the Organization description field reading IoTFlows demonstration plant. The Organization handle row sits between the logo and the name, and a Delete entire organization row and a Leave organization row sit below the description.](/images/admin/adm-org-01.webp)

*The Organization section of Organization Settings, with numbered callouts on the logo tile, the Organization name field, and the Organization description field.*

Use a square mark rather than a full wordmark. The logo renders at roughly 24 px in the organization switcher and in the organization lists in chat, and text that small is unreadable.

If the dialog stays open after **Submit** and no toast appears, the upload failed. This failure is silent, so nothing else tells you. Select **Submit** again, and if it fails twice, [contact IoTFlows](/docs/get-started/get-support/).

## Set the name
The name is what members read in the organization switcher, and what people in other organizations see next to your logo when they search for someone in chat.

1. Select **Edit**.
2. Type the name into **Organization name**, for example `Midwest Tooling`.
3. Select **Save**. An "Organization modified" toast confirms it.

Nothing checks the name against other organizations, so two companies can carry the same one. The handle is the field that has to be unique.

Renaming is safe: the name is in no URL and no report points at it.

## Add a description
The description is one optional line of free text.

1. Select **Edit**.
2. Type into **Organization description**, for example `Progressive die stamping, Sterling Heights`.
3. Select **Save**.

**You do not need this.** No screen in the web dashboard reads the description back out, so it is a note on the organization record rather than something your members see. Fill it in if you run several organizations and want the record to say which plant is which.

## Change the handle
The handle is the second half of every member's chat address. If your handle is `midwesttooling`, a member whose username is `jsmith` is reachable at `jsmith:midwesttooling`.

1. Select **Edit**.
2. Type the new handle into **Organization handle**. The field lowercases what you type and drops anything that is not a letter, a digit, or an underscore, so `Midwest Tooling!` leaves `midwesttooling`.
3. Wait half a second. IoTFlows checks the handle and marks the field with a green check if it is free, or a red exclamation icon if another organization already holds it.
4. Select **Save** once the icon is green.

![A cropped detail of the Organization handle row in edit mode. The focused field reads midwesttooling, and a green check circle sits immediately to the right of it, highlighted. The Organization name row, reading IoTFlows, sits below it for contrast.](/images/admin/adm-org-02.webp)

*The Organization handle field being edited. The icon to the right of the field is the availability check, green for free and red for taken.*

> **Warning:**
> **Why read the icon before saving?**
>
> **Save** is blocked neither while the check is running nor when the icon is red: the dashboard sends whatever is in the field. The check is advice. Type, pause, look at the icon, then save.

To hand your handle to someone, hover the handle row when the section is not in edit mode and select the copy icon that appears beside it. An "Organization handle copied!" toast confirms the copy. If your browser blocks clipboard access you get "Clipboard not supported" or "Failed to copy handle:" instead, and you can select the text and copy it by hand.

**Choose a handle you will not want to change.** It is how people outside your organization find you in chat, and the old one stops working the moment you change it.

## What changing the handle breaks
The warning icon beside the **Organization handle** label spells this out. Read it before you commit.

![A cropped detail of the Organization handle row with the warning tooltip open above it. The warning icon beside the Organization handle label is highlighted. The amber panel reads that changing this organization handle will update it for every user in the organization, that all message and chat handles will also change, and that this may cause issues for external users trying to find you with the previous handle, and closes with an italic example line reading Example with current organization handle, user:iotflows.](/images/admin/adm-org-03.webp)

*The warning on the Organization handle label: changing the handle changes it for every member, and rewrites every chat handle with it.*

Changing the handle rewrites the chat address of every member and every team in one step. `jsmith:midwesttooling` becomes `jsmith:mwtooling`, and so does everyone else's.

That is only a problem outside your organization. Your own members find each other by name in the [member directory](/docs/admin/manage-members/) and in chat, and never type a handle to do it.

People in other organizations do type it. Chat search looks up the exact address, so a supplier who saved `jsmith:midwesttooling` gets no match after the change, with no forwarding and no hint that the address moved. Send your external contacts their new addresses yourself.

Nothing else points at the handle. Dashboard URLs carry the organization's UUID, so bookmarks and links you have pasted into email keep working.

## Organization fields
| Field | Required | Visible to | Changing it breaks |
|---|---|---|---|
| **Organization logo** | No | Your members, in the organization switcher; anyone who sees your organization in a chat search | Nothing |
| **Organization name** | Yes | Your members, in the organization switcher; anyone who sees your organization in a chat search | Nothing |
| **Organization description** | No | Nobody, on any screen in the web dashboard | Nothing |
| **Organization handle** | Yes | Everyone on IoTFlows, as the second half of every member and team chat address | Every saved chat address anyone outside your organization holds for your people |

Apart from the handle's character filter, the browser validates none of these fields. If **Save** fails, the dashboard shows the error the API returned and closes edit mode without keeping your change; reopen **Edit** and try again.

## See also
- [Define shifts and your timezone](/docs/admin/shifts-and-timezone/), the other half of the same settings screen
- [Update your profile and handles](/docs/admin/profile/), where each member sets the username in front of the colon
- [Start a chat](/docs/messaging/start-a-chat/), where handles get used
- [Overview: administer your organization](/docs/admin/overview/)