> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comments and Notifications

> Collaborate with comments and stay informed with notifications on shared documents.

Comments and notifications help you communicate with collaborators on shared documents, whether you're working with family, friends, or teammates.

## Adding Comments

You can add comments to any block in a shared document.

**Step 1**

Select a block of content.

**Step 2**

Click the three-dot menu (⋯) in the block menu.

**Step 3**

Select **Add comment**.

![Adding a comment to a block](https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/introduction/navigation/comments/en/content/add-comment.gif?s=58a6779eb902ad21cbc47fdd7b7d09db)

## Formatting Comments

Comments support basic text formatting to help you communicate more effectively:

* **Bold**, *italic*, and ~~strikethrough~~
* Links
* Inline code

![Applying formatting styles to comments](https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/introduction/navigation/comments/en/content/comment-styling.gif?s=34cdd484eb1415fb60550715edcc1039)

## Viewing Notifications

The notifications panel gives you a quick overview of all activity on your shared documents.

**Step 1**

Navigate to the notification bell icon in the sidebar.

**Step 2**

View all unread notifications across your spaces.

**Step 3**

Click into any notification to jump directly to the relevant document and comment.

The app icon will display a badge showing the number of unread notifications across all your spaces.

On Mac, hovering over an item in the notifications panel shows a preview of the document it belongs to.

![Notifications panel showing unread activity](https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/introduction/navigation/comments/en/content/notifications-overview.gif?s=71d4fe696cdafe7ecc3863739e0552d1)

> [!NOTE]
>
> You'll receive notifications when:
>
> * Someone comments on a block you created
> * Someone mentions you in a comment or document

## Replying to Comments

Navigate directly to comments from the notifications panel and reply in-line.

![Replying to a comment thread](https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/introduction/navigation/comments/en/content/reply-comment.gif?s=a0e3a32105caed0efa26f031393c6991)

## Email Notifications

Open **Settings > Notifications**. Under **Comments & Mentions**, turn **Email Notifications** on or off to change the default for your spaces.

To change a single space, select it under **Spaces** and change **Email Notifications** there.

> [!NOTE]
>
> Per-space settings override the default. These settings control emails from spaces you belong to. Comment and mention emails from documents shared with you in other spaces may still arrive. Contact [support@craft.do](mailto:support@craft.do) if you need help stopping them.

[Email Preferences](https://craft-support.mintlify.site/account-and-subscription/profile-settings/email-preferences).

## Push Notifications

Push notifications provide real-time alerts for:

* Comments on blocks you created
* Mentions in documents or comment threads

To enable push notifications:

> [tab] macOS
>
> **Step 1**
>
> Go to **Preferences** in Craft.
>
> **Step 2**
>
> Under **Space Management**, select your space.
>
> **Step 3**
>
> Go to **Space Settings**.
>
> **Step 4**
>
> Click **Open System Preferences**.
>
> **Step 5**
>
> Navigate to **Craft** in System Settings.
>
> **Step 6**
>
> Turn on **Allow Notifications**.
>
> ![Enabling push notifications on macOS through System Settings](https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/introduction/navigation/comments/en/content/push-settings.gif?s=bf777e4dd8138dcc72f6178b1ce7476b)

> [tab] iOS
>
> **Step 1**
>
> Open iOS **Settings** app.
>
> **Step 2**
>
> Scroll to **Craft**.
>
> **Step 3**
>
> Tap **Notifications**.
>
> **Step 4**
>
> Turn on **Allow Notifications**.
>
> **Step 5**
>
> Configure your preferred notification style (banners, sounds, badges).

> [!WARNING]
>
> Notification sounds are currently disabled in the app, but system-level notification sounds will still work if enabled in your device settings.

## Related Articles

> [card] [Sharing Documents](https://craft-support.mintlify.site/share-and-publish/share)
>
> Learn how to share and collaborate on documents

> [card] [Team Collaboration](https://craft-support.mintlify.site/organize-and-find/teams)
>
> Work together with team spaces and permissions


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.