> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://breakcold-aicrm.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How To Customize an Object

## Overview
Objects are the core data structures in BreakCRM — they define how your records (People, Companies, Deals, etc.) are named and displayed throughout the app. You can customize each object's appearance and behavior from the **Records** settings page.

Each object can be customized with:
* **Singular & Plural Name** — how the object is labeled in the interface
* **Icon** — the visual icon shown next to the object in the sidebar and lists
* **Color** — the accent color used for the object throughout the app
* **Active status** — whether the object is visible in the sidebar

## Step 1 — Navigate to Records Settings
1. Click **Settings** at the bottom of the left sidebar.
2. In the Settings sidebar, click **Records** under the *Data* section.

![](https://storage.crisp.chat/users/helpdesk/website/-/c/f/1/8/cf18dcba819a5000/image_tf1wgm.png)
*The Records page lists all your objects — People, Companies, and Deals — with their type, record count, and attribute count.*
| Note: System objects (People, Companies, Deals) are marked with a lock icon and cannot be deleted, but all their appearance settings can be freely customized.
## Step 2 — Open an Object's Settings
3. Click the arrow `→` on the right of any object row, or click directly on the object name, to open its settings page.
![](https://storage.crisp.chat/users/helpdesk/website/-/c/f/1/8/cf18dcba819a5000/image_j25xt4.png)*The object settings page — here shown for the **People** object — with all customization options: name, icon, color, and active toggle.*
## Step 3 — Edit the Singular & Plural Name
The **Singular Name** is used when referring to a single record (e.g., *Person*), while the **Plural Name** is used in lists and navigation (e.g., *People*).
4. Click the **Singular Name** field and type your preferred label (e.g., *Contact*, *Lead*, *Person*).
![](https://storage.crisp.chat/users/helpdesk/website/-/c/f/1/8/cf18dcba819a5000/image_15fv8o4.png)*Editing the Singular Name — the banner "You have unsaved changes" appears as soon as you make an edit.*
5. Click the **Plural Name** field and update it to match your singular name (e.g., *Contacts*, *Leads*).
![](https://storage.crisp.chat/users/helpdesk/website/-/c/f/1/8/cf18dcba819a5000/image_1g2kd.png)*The Plural Name field — update this to keep labeling consistent across the app.*
## Step 4 — Choose an Icon
The icon appears next to the object name in the sidebar and throughout the interface. A grid of icon options is available to choose from.
6. In the **Icon** section, browse the icon grid and click any icon to select it. The object preview updates immediately.
Hovering over the icon grid — click any icon to apply it to the object instantly.
![](https://storage.crisp.chat/users/helpdesk/website/-/c/f/1/8/cf18dcba819a5000/image_1s96k7w.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/c/f/1/8/cf18dcba819a5000/image_zgezh0.png)A new icon selected — the object header updates to reflect the new icon in real time.
## Step 5 — Choose a Color
The color is used as an accent for the object's icon and UI elements throughout the app, making it easy to visually distinguish objects at a glance.

7. In the **Color** section, click any color swatch to apply it. The icon in the header updates immediately to preview the selected color.

![](https://storage.crisp.chat/users/helpdesk/website/-/c/f/1/8/cf18dcba819a5000/image_192rw8e.png)The color palette — click any swatch to apply it. Available colors include blue, green, orange, red, purple, teal, pink, and more.
## Step 6 — Set the Active Status
The **Active** toggle controls whether the object appears in the sidebar navigation. Inactive objects are hidden from view but their data is preserved.
8. Toggle **Active** on or off depending on whether you want this object visible in the sidebar.
| Tip: Use the Active toggle to temporarily hide objects you're not currently using — without losing any records or data associated with them.
## Step 7 — Save Your Changes
9. Click **Save Changes** to apply all your customizations. The banner will update to *"All changes saved"* once confirmed.
![](https://storage.crisp.chat/users/helpdesk/website/-/c/f/1/8/cf18dcba819a5000/image_w1y6z1.png)The "All changes saved" confirmation — your object's name, icon, and color are now updated across the entire workspace.
| Note: Changes apply immediately across the entire workspace for all members. Make sure your naming and color choices are aligned with your team's conventions before saving.
## Customization Options at a Glance
| Setting | What It Controls | Applies To |
| ---- |
| **Singular Name** | Label for a single record (e.g., "Person") | Record detail pages, forms |
| **Plural Name** | Label for multiple records (e.g., "People") | Sidebar, list views, navigation |
| **Icon** | Visual icon for the object | Sidebar, object headers, lists |
| **Color** | Accent color for the object | Icon color, UI highlights |
| **Active** | Visibility in the sidebar | Sidebar navigation only |
## Frequently Asked Questions
**Can I rename system objects like People, Companies, and Deals?**
Yes. Even though system objects cannot be deleted, you can freely rename them, change their icon, and change their color.
**Will renaming an object affect existing records?**
No. Renaming only affects how the object is labeled in the interface. All existing records, fields, and data remain intact.
**Can I create a completely new object type?**
Yes. From the Records settings page, click **+ Create Object** in the top-right corner to define a new custom object.
**What happens if I deactivate an object?**
It will be hidden from the sidebar but all its records and fields are preserved. You can reactivate it at any time by toggling Active back on.
**Do color and icon changes affect all workspace members?**
Yes. Object customizations are workspace-wide and apply to all members immediately after saving.