# Notifications

The notification system keeps you informed about important events, hot deals, and system updates. Never miss an opportunity or important information.

### You’ll learn

* What notifications exist.
* Where to read them (dashboard vs main app).
* How to mark read and clean up.

## Notification Types

### Hot Deal Alerts

**When They Trigger:**

* Exceptional deal detected
* Price significantly below average
* Score 6 or higher (typically)

**What They Show:**

* Listing title and price
* Percentage below average
* Hot deal score
* Link to view details

**Example:**

```
🔥 Hot Deal Alert
2018 Honda Civic LX - $12,500
23% below average (Score: 9/10)
View Details →
```

### System Notifications

**Types:**

* **Scraping Completed**: Session finished successfully
* **Errors**: Issues that occurred during scraping
* **Warnings**: Important notices about operations
* **Updates**: System or feature updates

**Examples:**

* "Scraping session completed: 147 listings found"
* "Warning: Slow connection detected"
* "Error: Failed to extract listing details"

## Viewing Notifications

### In the Dashboard

{% stepper %}
{% step %}

### Navigate to Notifications

* Click "🔔 Notifications" in top navigation
* Notifications page opens

![Dashboard Notifications page showing unread vs read styling](/files/zZxeQDtsd8eNsOaTTXbV)

*Dashboard Notifications page.*
{% endstep %}

{% step %}

### View All Notifications

* See all notifications (read and unread)
* Most recent first
* Unread notifications highlighted
  {% endstep %}

{% step %}

### Filter Notifications

* Filter by type (Hot Deal, System, etc.)
* Show only unread
* Show all notifications
  {% endstep %}

{% step %}

### Notification Details

* Click notification to view details
* Hot deals link to listing
* System notifications show full message
  {% endstep %}
  {% endstepper %}

### In the Main App

{% stepper %}
{% step %}

### Open Alerts

* Click "🔔 Alerts" in sidebar
* Alerts modal opens

![Main app Alerts modal showing hot deals and system alerts](/files/1HtHkfgswsQJfkc3CAMt)

*Main app Alerts modal.*
{% endstep %}

{% step %}

### View Notifications

* See hot deals and alerts
* Quick access without dashboard
* Same information available
  {% endstep %}

{% step %}

### Quick Actions

* View hot deal details
* Navigate to listing
* Dismiss notifications
  {% endstep %}
  {% endstepper %}

## Managing Notifications

### Mark as Read

**Individual:**

* Click on a notification
* Automatically marked as read
* Highlighting removed

**All at Once:**

* Click "Mark All Read" button
* All notifications marked as read
* Badge count resets

### Delete Notifications

**Individual:**

* Click delete icon on notification
* Removed from list immediately
* Cannot be undone

**Bulk Delete:**

* Select multiple notifications
* Click "Delete Selected"
* Removed in bulk

### Filter Notifications

**By Type:**

* Hot Deal alerts only
* System notifications only
* All types

**By Status:**

* Unread only
* Read only
* All notifications

## Notification Badge

### Badge Indicator

**Location:**

* Top navigation bar
* Next to "🔔 Notifications" link
* Red badge with number

**What It Shows:**

* Number of unread notifications
* Updates automatically
* Clears when all read

**Example:**

* Badge shows "5" = 5 unread notifications
* Badge shows "99+" = 99+ unread
* No badge = all read

![Top navigation showing Notifications unread badge](/files/kqYvEn3NttjTARFdnB4Z)

*Unread badge in the top navigation.*

### Badge Behavior

* **Updates in Real-Time**: New notifications appear immediately
* **Auto-Refresh**: Dashboard refreshes every 10 seconds
* **Click to View**: Click badge or link to go to notifications

## Notification Settings

### Preferences

**Available Settings:**

* Notification types to show
* Sound alerts (if available)
* Desktop notifications (if available)
* Email alerts (future feature)

**Access:**

* Dashboard Settings page
* Notification preferences section
* Save to apply changes

## Best Practices

{% stepper %}
{% step %}

### Check Regularly

* Review notifications daily
* Don't let them pile up
* Act on hot deals quickly
* Address errors promptly
  {% endstep %}

{% step %}

### Organize by Priority

* Hot deals: High priority
* Errors: Address immediately
* Warnings: Review when convenient
* System updates: Informational
  {% endstep %}

{% step %}

### Use Filters

* Filter by type for focused view
* Show unread when checking
* Use search if needed
* Organize for efficiency
  {% endstep %}

{% step %}

### Clean Up

* Delete old notifications
* Mark as read when done
* Keep list manageable
* Archive important ones (future feature)
  {% endstep %}
  {% endstepper %}

***

### Next pages

* Configure behavior: [Settings](/web-dashboard/settings.md)
* Fix issues: [Troubleshooting](/help/troubleshooting.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hivefb.app/web-dashboard/notifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
