# Settings

Settings live in two places.

The **main app** Settings are mostly for **maintenance**. Think: delete local data, or factory reset.

The **web dashboard** Settings are for **how you view data**. Think: sorting, filters, refresh, and display preferences.

### You’ll learn

* Where settings live (main app vs dashboard).
* What “delete data” vs “factory reset” actually does.
* How to back up before you wipe anything.

## Where settings live

* **Scraping behavior**: usually per-catalogue. See [Catalogue Management](/core-workflow/catalogue-management.md).
* **Viewing data**: dashboard Settings.
* **Wiping local data**: main app Settings.

## Main app settings (maintenance)

### Accessing Settings

{% stepper %}
{% step %}

### Open Settings

* Click "⚙️ Settings" in the sidebar
* The Settings modal opens

![Main app Settings modal with delete data and factory reset actions](/files/PnVQuQ0lDMce4coyxKoj)

*Main app Settings modal (maintenance actions).*
{% endstep %}

{% step %}

### Pick an action

* Most options are destructive
* Read the confirmation text carefully
  {% endstep %}
  {% endstepper %}

### Delete local data

Use this when you want a clean database, but don’t want to reinstall.

Typical deletes include:

* Listings database (what the dashboard shows)
* Exported scrape files (JSON)
* Cached / temporary app data

{% hint style="warning" %}
This is usually **not reversible**. Back up first if you care about the data.
{% endhint %}

### Factory reset

Use this when the app is acting weird and you want to start over.

Factory reset typically wipes:

* Database + scraped exports
* App settings
* Any local state that could cause bugs

{% hint style="danger" %}
Treat this like uninstall + reinstall, but faster. Expect to reconfigure things after.
{% endhint %}

### Back up before wiping

If you might want the data later, copy the HiveFB data folder somewhere safe.

Common location on Windows:

* `C:\Users\<YourUsername>\AppData\Roaming\HiveFB\`

At minimum, back up:

* `database/` (your listings)
* `scraped_data/` (exports, if you use them)

## Dashboard settings (preferences)

### Accessing Settings

{% stepper %}
{% step %}

### Open Dashboard

* Navigate to dashboard
* Click "⚙️ Settings" in navigation

![Dashboard Settings opened from the top navigation](/files/wWIPGCnKLhwWYcOZGJyr)

*Dashboard Settings page.*
{% endstep %}

{% step %}

### Configure Preferences

* Change the values you want
* Save to apply changes (if shown)
  {% endstep %}
  {% endstepper %}

### Display Preferences

**Listings Display:**

* **Items Per Page**: How many listings per page
* **Default Sort**: Default sorting method
* **Default Filter**: Default type filter (All/Vehicles/Items)
* **Card Size**: Listing card size preference (if available)

**View Options:**

* **Show Images**: Display listing images
* **Show Descriptions**: Show full descriptions
* **Compact Mode**: More listings per page

### Refresh Settings

**Auto-Refresh:**

* **Enable/Disable**: Turn auto-refresh on/off
* **Refresh Interval**: How often to refresh (default: 10 seconds)
* **Background Refresh**: Refresh when tab not active (if available)

**Manual Refresh:**

* **Refresh Button**: Manual refresh option
* **Keyboard Shortcut**: Quick refresh key

### Filter Defaults

**Default Filters:**

* **Type Filter**: Default type selection
* **Price Range**: Default price filter
* **Sort Order**: Default sort direction

**Saved Filters:**

* **Save Current Filter**: Save filter as default
* **Reset to Defaults**: Restore original defaults

## Resetting

### Dashboard: reset preferences

{% stepper %}
{% step %}

### Dashboard

* Open Dashboard Settings
* Find reset option
* Confirm action
* Settings restored
  {% endstep %}
  {% endstepper %}

### Main app: factory reset

Factory reset is the “big hammer”.

Use it when you want to remove all local HiveFB state.

## Local files (Windows)

### Location

HiveFB stores data under your Windows roaming profile:

* `C:\Users\<YourUsername>\AppData\Roaming\HiveFB\`

Common files/folders:

* `database/` (SQLite DB)
* `scraped_data/` (exports)
* `settings.json` (app settings, if present)

### Backup

**Manual Backup:**

* Close HiveFB first
* Copy the full `HiveFB` folder
* Store in safe location
* Restore if needed

## FAQ

<details>

<summary>Open FAQ</summary>

See the FAQ page: [FAQ](/help/faq.md)

</details>


---

# 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/settings.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.