# Create a user

Copy as Markdown[View as Markdown](/docs/development/guides/owners/create-user.md)

***

A user represents a person who owns, maintains, or can answer questions about resources in your architecture.

![Example user page](/assets/images/example-a6f87c826d19c5635149acbe65333325.png)

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

### Automatic Creation[​](#automatic-creation "Direct link to Automatic Creation")

Copy this prompt and paste it into your coding agent. Your agent can create the user file and add the right ownership/contact metadata.

### Manual Creation[​](#manual-creation "Direct link to Manual Creation")

Users live in the `/users` folder.

Create one `.mdx` file for each user.

* users
  <!-- -->
  /
  * dboyne.mdx

## Create the user file[​](#create-the-user-file "Direct link to Create the user file")

Create a user file with frontmatter and markdown content.

/users/dboyne.mdx

```
---
# id of the user, used for references from resources
id: dboyne

# display name for the user
name: David Boyne

# optional URL path for a profile image
avatarUrl: https://github.com/dboyne.png

# user's role in the company
role: Lead developer

# optional user email address
email: david@example.com

# optional Slack URL to contact the user
slackDirectMessageUrl: https://yourteam.slack.com/team/dboyne

# optional teams this user belongs to
associatedTeams:
  - payments-platform
---

## Overview

David works on platform architecture and helps teams document their event-driven systems.
```

Once the file is added, the user appears in EventCatalog and can be referenced by resources or teams.

## Add users to teams[​](#add-users-to-teams "Direct link to Add users to teams")

Teams can reference users in their `members` array:

/teams/payments-platform.mdx

```
---
id: payments-platform
name: Payments Platform
members:
  - dboyne
---
```

## Next steps[​](#next-steps "Direct link to Next steps")

* [Create a team](/docs/development/guides/owners/create-team.md)
* [Review the users reference](/docs/development/guides/owners/users-reference.md)
* [Sync users from external systems](/docs/development/guides/owners/automated-teams-and-users.md)