> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metaphysical-labs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Messages and Revisions

> Learn how to communicate with the team and request changes.

Messages help keep project communication in one place. Use messages instead of scattered email threads whenever possible.

## Messages

Use the **Messages** page to:

* Ask project questions and clarify requirements.
* Send notes or files to the team during production.
* Reply to project updates and share revision feedback.
* Keep communication tied to the correct project instead of scattering conversations across email.

### Starting a new conversation

1. On the Messages page, click **Start New Chat** to open the New Chat modal.
2. Search for a contact by typing their name in the search bar. Select the contact to open or create a new thread.
3. The conversation view opens with the thread title at the top. If a thread doesn’t exist yet, it will be created automatically.
4. Compose your opening message and press **Send**.

### Sending messages and attachments

1. In the message composer at the bottom of the conversation, type your message in the text area. Press **Enter** to send, or **Shift+Enter** to add a new line.
2. To add attachments, click the paperclip icon or choose **Attach File**. You can attach image, PDF, or video files.
3. Use the toolbar to insert emojis, add bold formatting, or mention a teammate using **@** followed by their name. Selecting a mention from the picker automatically inserts it into your message.
4. When ready, click **Send**. Attachments will be uploaded automatically and appear in the message history.

### Viewing and navigating conversations

* The left sidebar shows your conversation list. Use the search bar at the top to filter threads by keyword.
* Click a conversation to load it in the main view. Messages are grouped by day with a date label.
* The conversation header shows the thread title, participants, and an icon to open attachments.
* At the bottom of the conversation view, a footer displays the number of participants and attachments in the thread.
* Click an attachment inside the message history to open or download it.

## Requesting revisions

When requesting changes, be specific.

A helpful revision note includes:

* What needs to change
* Where the issue appears
* What the correct version should look like
* Any reference files or examples that help explain the change

## Example revision note

```text theme={null}
Please update step 4. The screw placement should show two screws on the left side instead of one. I uploaded a reference image in the Assets section.
```

## Best practices

Keep each message focused on one topic when possible.

If you have multiple changes, list them clearly so the team can review each one.