upstream-twenty/packages/twenty-docs/user-guide/data-model/capabilities/objects.mdx

---
title: Objects
description: Learn about standard and custom objects in Twenty.
---

import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';


## Standard Objects

Standard objects are predefined entities in your workspace to help you get started. They're part of a shared data model accessible to all users of Twenty. You can use them as-is, customize them or deactivate them.

<img src="/images/user-guide/objects/standard-objects.png" style={{width:'100%'}}/>

### People

The `People` object stores your contacts. It includes contact details and interaction history, so you can see all your customer interactions in one place.

### Companies

The `Companies` object stores your business accounts. It includes details like industry, size and location. Companies connect to both `People` and `Opportunities` objects.

### Opportunities

The `Opportunities` object stores deal-related data. It tracks the progression of potential sales, from prospecting to closure, recording stages, deal sizes, associated account, and expected close date. You can view your sales pipeline in a kanban layout.

### Notes

The `Notes` object stores free-form notes that can be attached to People, Companies, Opportunities, and other records. Use notes to capture meeting summaries, important details, or any contextual information.

### Tasks

The `Tasks` object stores to-dos and action items. Tasks can be linked to People, Companies, Opportunities, and other records. Track due dates, assignees, and completion status to stay on top of your follow-ups.

## Custom Objects

Custom objects let you store information that's unique to your organization and that standard objects can't handle. For example, if you're SpaceX, you may want to create a custom object for Rockets and Launches.

<img src="/images/user-guide/objects/custom-objects.png" style={{width:'100%'}}/>

### Creating a New Custom Object

To create a new custom object:

1. Go to Settings in the sidebar on the left.
2. Under Workspace, go to Data Model. Here you'll be able to see an overview of all your existing Standard and Custom objects (both active and deactivated).

<VimeoEmbed videoId="926288174" title="Video demonstration" />

3. Click on `+ New object` at the top. Enter the name (both singular and plural), choose an icon, and add a description for your custom object and hit Save (at the top right). Using Listing as an example of custom object, the singular would be "listing" and the plural would be "listings" along with a description like "Listings that hosts created to showcase their property."
4. Your custom object is now created and will appear in your sidebar. You can start adding records to it right away.

## Managing Objects

### Deactivating Objects
If you don't need a standard or custom object:
1. Go to Settings → Data Model
2. Find the object you want to deactivate and click it
3. Go to object's **Settings** tab
4. Click `Deactivate` button
5. The object will be hidden from your workspace but data is preserved

### Reactivating Objects
To bring back a deactivated object:
1. Go to Settings → Data Model
2. Enable `Deactivated` filter
3. Look for deactivated objects (they have `Deactivated` next to their name)
4. Click `⋮` and then `Activate` to reactivate it
5. The object and all its data will be restored

## Best Practices

### When to Create Custom Objects
- **Unique business entities**: Things specific to your industry or process
- **Complex relationships**: When you need to track connections between multiple entities
- **Scalable data**: When you might have many instances of something

### When to Use Fields Instead
- **Simple attributes**: Properties that describe existing objects
- **Categories or labels**: Ways to classify existing records
- **Single values**: Information that doesn't need its own lifecycle

### Object Naming
- **Use clear, descriptive names**: Make it obvious what the object represents
- **Follow conventions**: Use singular for the object name, plural for the collection
- **Consider your team**: Choose names everyone will understand