> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.app/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.

<Steps>
  <Step>
    Select a block of content.
  </Step>

  <Step>
    Click the three-dot menu (⋯) in the block menu.
  </Step>

  <Step>
    Select **Add comment**.
  </Step>
</Steps>

<img src="https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/introduction/navigation/comments/en/content/add-comment.gif?s=58a6779eb902ad21cbc47fdd7b7d09db" alt="Adding a comment to a block" width="1680" height="1048" data-path="images/introduction/navigation/comments/en/content/add-comment.gif" />

## Formatting Comments

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

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

<img src="https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/introduction/navigation/comments/en/content/comment-styling.gif?s=34cdd484eb1415fb60550715edcc1039" alt="Applying formatting styles to comments" width="1680" height="1048" data-path="images/introduction/navigation/comments/en/content/comment-styling.gif" />

## Viewing Notifications

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

<Steps>
  <Step>
    Navigate to the notification bell icon in the sidebar.
  </Step>

  <Step>
    View all unread notifications across your spaces.
  </Step>

  <Step>
    Click into any notification to jump directly to the relevant document and comment.
  </Step>
</Steps>

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

<img src="https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/introduction/navigation/comments/en/content/notifications-overview.gif?s=71d4fe696cdafe7ecc3863739e0552d1" alt="Notifications panel showing unread activity" width="1680" height="1048" data-path="images/introduction/navigation/comments/en/content/notifications-overview.gif" />

<Info title="Notification Triggers">
  You'll receive notifications when:

  * Someone comments on a block you created
  * Someone mentions you in a comment or document
</Info>

## Replying to Comments

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

<img src="https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/introduction/navigation/comments/en/content/reply-comment.gif?s=a0e3a32105caed0efa26f031393c6991" alt="Replying to a comment thread" width="1680" height="1048" data-path="images/introduction/navigation/comments/en/content/reply-comment.gif" />

## Email Notifications

Email notifications are sent hourly and contain all unread notifications from the previous time period.

To enable or disable email notifications:

<Steps>
  <Step>
    Go to **Preferences** (macOS) or **Settings** (iOS, Web app, or Windows).
  </Step>

  <Step>
    Under **Space Management**, select the space you want to configure.
  </Step>

  <Step>
    Go to **Space Settings**.
  </Step>

  <Step>
    Toggle **Email notifications** on or off.
  </Step>
</Steps>

<img src="https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/introduction/navigation/comments/en/content/email-settings.gif?s=7f91078bc313d0d8feb6db3d3f4af43c" alt="Configuring email notification settings for a space" width="1680" height="1048" data-path="images/introduction/navigation/comments/en/content/email-settings.gif" />

<Info title="Multiple Spaces">
  To enable or disable email notifications for multiple spaces, repeat these steps for each space individually.
</Info>

## Push Notifications

Push notifications provide real-time alerts for:

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

To enable push notifications:

<Tabs>
  <Tab title="macOS">
    <Steps>
      <Step>
        Go to **Preferences** in Craft.
      </Step>

      <Step>
        Under **Space Management**, select your space.
      </Step>

      <Step>
        Go to **Space Settings**.
      </Step>

      <Step>
        Click **Open System Preferences**.
      </Step>

      <Step>
        Navigate to **Craft** in System Settings.
      </Step>

      <Step>
        Turn on **Allow Notifications**.
      </Step>
    </Steps>

    <img src="https://mintcdn.com/craft-support/wb5Ce6cIohLU54lt/images/introduction/navigation/comments/en/content/push-settings.gif?s=bf777e4dd8138dcc72f6178b1ce7476b" alt="Enabling push notifications on macOS through System Settings" width="1680" height="1048" data-path="images/introduction/navigation/comments/en/content/push-settings.gif" />
  </Tab>

  <Tab title="iOS">
    <Steps>
      <Step>
        Open iOS **Settings** app.
      </Step>

      <Step>
        Scroll to **Craft**.
      </Step>

      <Step>
        Tap **Notifications**.
      </Step>

      <Step>
        Turn on **Allow Notifications**.
      </Step>

      <Step>
        Configure your preferred notification style (banners, sounds, badges).
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Warning title="Note">
  Notification sounds are currently disabled in the app, but system-level notification sounds will still work if enabled in your device settings.
</Warning>

## Related Articles

<CardGroup cols={2}>
  <Card title="Sharing Documents" href="/en/share-and-publish/share">
    Learn how to share and collaborate on documents
  </Card>

  <Card title="Team Collaboration" href="/en/organize-and-find/teams">
    Work together with team spaces and permissions
  </Card>
</CardGroup>