# Creating domains

Copy as Markdown[View as Markdown](/docs/development/guides/domains/creating-domains/adding-domains.md)

***

Domains are a great way to group your documentation into logical units that can be represented in your organization.

EventCatalog Domains are inspired by the [Domain-Driven Design](/docs/development/guides/domains/introduction.md) approach.

In EventCatalog a domain is a logical unit that contains related [services](/docs/development/guides/services/introduction.md), [entities](/docs/development/guides/domains/entities/introduction.md), [messages](/docs/development/guides/messages/overview.md), subdomains, and other resources.

### What do domains look like in EventCatalog?[​](#what-do-domains-look-like-in-eventcatalog "Direct link to What do domains look like in EventCatalog?")

![Example](/assets/images/domain-example-52a66b38454bdc8688efde60a967b748.png)

## Adding a new domain[​](#adding-a-new-domain "Direct link to Adding a new domain")

To add a new domain create a new folder within the `/domains` folder with an `index.mdx` file.

* `/domains/{Domain Name}/index.mdx`
  * (example `/domains/Orders/index.mdx`)

The `index.mdx` contents are split into two sections, [**frontmatter**](/docs/api/domain-api.md) and the [**markdown content**](#adding-content).

*Here is an example of what a domain markdown file may look like.*

/domains/Orders/index.mdx (example)

```
---
# id of your domain, used for slugs and references in EventCatalog.
id: Orders

# Display name of the domain, rendered in EventCatalog
name: Orders

# Version of the domain
version: 0.0.1

# Short summary of your domain
summary: |
  Domain that contains order related information

# Optional owners, references teams or users
owners:
    - dboyne

# Optional services. Groups services into this domain.
services:
    - id: PaymentService
      version: 0.0.1

# Optional flows associated with this domain
flows:
    - id: OrderProcessing
      version: 1.0.0

# Optional badges, rendered to UI by EventCatalog
badges:
    - content: New domain
      backgroundColor: blue
      textColor: blue
---

## Overview

Domain that contains all services that are related to the orders domain within FakeCompany.

<NodeGraph />
```

**That's it!**

Once you add your domain it will appear in your catalog.

## Adding content[​](#adding-content "Direct link to Adding content")

Your domain page will render the markdown content you add to the file. To add content to your domain page, add markdown to the file.

/domains/Orders/index.mdx

```
---
id: Orders
version: 0.0.1
name: Orders
---

## Overview

This is your domain markdown....

You can add anything here...

Including EventCatalog components

<NodeGraph />
```

## Using components[​](#using-components "Direct link to Using components")

EventCatalog supports [MDX](https://mdxjs.com/) under the hood. This gives you the ability to use components inside your domain page.

You can find a list of EventCatalog components you can use here: [EventCatalog components](/docs/development/components/using-components.md).