# Settings

This page summarizes common settings so you can tune behavior, performance, and sync based on your workflow.

## Setting groups

| Group | Purpose | Typical scenario |
|------|------|------|
| History | Control retention, filtering, and cleanup | Large history or noise reduction |
| Sync | Configure Nearby Sync and Cloud Sync scope | Multi-device collaboration |
| Shortcuts and UI | Tune hotkeys and quick input behavior | High-frequency workflows |
| Privacy and Security | Control sensitive data handling | Compliance and privacy-sensitive usage |
| Performance | Balance background behavior and resource usage | Low-end devices or stability-first setups |

## Recommended setup sequence

:::steps
:::step{title="Configure history first"}

Set retention limits, deduplication, and cleanup strategy.

:::
:::step{title="Configure sync second"}

Choose Nearby Sync, Cloud Sync, or a hybrid model and define sync scope.

:::
:::step{title="Tune shortcuts and performance last"}

Refine hotkeys and background mode for your device profile.
:::
:::

## Starter preset example

```yaml title="Starter Settings Example"
history:
  maxItems: 1000
  deduplicate: true
sync:
  nearby: true
  cloud:
    enabled: false
shortcuts:
  quickInput: "Ctrl+Shift+V"
performance:
  backgroundMode: "balanced"
```

> [!INFO] Configuration guidance
> Start conservative, validate stability, then expand capacity and automation.

## Common issues

:::accordion
:::item{label="Why do setting changes not take effect?"}

Confirm you saved changes and restarted the app. Some permission-related settings require re-authorization.

:::
:::item{label="How can I prevent history from growing too fast?"}

Enable deduplication, reduce retention capacity, and apply periodic cleanup rules.
:::
:::

## Related docs

:::cards{cols=2}
:::card{title="Platform Differences" icon="lucide.git-compare" href="/advanced/platform-differences"}
Understand capability boundaries across operating systems.

:::
:::card{title="Privacy and Security" icon="lucide.shield" href="/advanced/privacy-security"}
Apply stronger data protection controls.
:::
:::