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

# Overview

> In-app notification records triggered by user interactions and system events

App Notifications are persistent, database-backed records delivered to users when activity happens in your app — new comments, replies, mentions, reactions, follows, connection requests, and more. They are distinct from push notifications; they live in the Sublay database and are surfaced through the SDK.

<Note>
  **Requires the `notifications` bundle.** App notifications are only available when the `notifications` bundle is installed on your project. See [Bundles](/v8/bundles) to add it.
</Note>

## How It Works

Sublay automatically creates notification records when relevant events occur (e.g., someone comments on an entity, someone follows a user). Your app polls or fetches those records and displays them in a notification feed. When push delivery is also needed, a webhook fires at the same time so your backend can forward the event to FCM or APNs.

## In This Section

<CardGroup cols={2}>
  <Card title="Hook" href="/v8/sdk/app-notifications/hook">
    How to use `useAppNotifications` — fetch notifications, unread count, and mark as read
  </Card>

  <Card title="Notification Templates" href="/v8/sdk/app-notifications/notification-templates">
    Customize the display text for each notification type
  </Card>

  <Card title="Webhook Integration" href="/v8/sdk/app-notifications/webhook-integration">
    Forward notifications to push services via webhook
  </Card>
</CardGroup>

## Hooks

<CardGroup cols={1}>
  <Card title="useAppNotifications" href="/v8/hooks/app-notifications/use-app-notifications">
    Full API reference for `useAppNotifications`
  </Card>
</CardGroup>

## Notification Types

Sublay generates notifications for the following events:

| Type | Trigger |
| - | - |
| `entity-comment` | Someone comments on your entity |
| `comment-reply` | Someone replies to your comment |
| `entity-mention` | You are mentioned in an entity |
| `comment-mention` | You are mentioned in a comment |
| `entity-upvote` | Someone upvotes your entity |
| `comment-upvote` | Someone upvotes your comment |
| `entity-reaction` | Someone reacts to your entity |
| `comment-reaction` | Someone reacts to your comment |
| `entity-reaction-milestone-specific` | Your entity reaches a milestone for a specific reaction type |
| `entity-reaction-milestone-total` | Your entity reaches a total reaction milestone |
| `comment-reaction-milestone-specific` | Your comment reaches a milestone for a specific reaction type |
| `comment-reaction-milestone-total` | Your comment reaches a total reaction milestone |
| `new-follow` | Someone follows you |
| `connection-request` | Someone sends you a connection request |
| `connection-accepted` | Someone accepts your connection request |
| `space-membership-approved` | A moderator approves your pending space membership request |
| `system` | A custom message sent from the dashboard |


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