---
title: "Lighthouse Config & Desktop/Mobile Presets · Unlighthouse"
meta:
  "og:description": "Customize Lighthouse audit categories, throttling, and desktop/mobile presets in Unlighthouse. Pass any lighthouseOptions directly."
  "og:title": "Lighthouse Config & Desktop/Mobile Presets · Unlighthouse"
  description: "Customize Lighthouse audit categories, throttling, and desktop/mobile presets in Unlighthouse. Pass any lighthouseOptions directly."
---

**Guides**

# **Lighthouse Config & Desktop/Mobile Presets**

[Copy for LLMs](https://unlighthouse.dev/guide/guides/lighthouse.md)

Customize audit categories, performance thresholds, and behavior through the `lighthouseOptions` configuration key. Unlighthouse passes these options directly to Google Lighthouse.

```
import { defineUnlighthouseConfig } from 'unlighthouse/config'

export default defineUnlighthouseConfig({
  lighthouseOptions: {
    throttlingMethod: 'devtools',
  },
})
```

For complete options, see the [**Lighthouse Configuration docs**](https://raw.githubusercontent.com/GoogleChrome/lighthouse/refs/heads/main/docs/configuration.md).

## [Aliases](#aliases)

Unlighthouse aims to minimise and simplify configuration, where possible.

For this reason, a number of configurations aliases are provided for your convenience.

- [**Switching device: mobile and desktop**](https://unlighthouse.dev/guide/guides/device)
- [**Toggle Throttling**](https://unlighthouse.dev/guide/guides/device#network-throttling)

You can always configure lighthouse directly if you are comfortable with the configuration.

## [Selecting Categories](#selecting-categories)

By default, Unlighthouse will scan the categories: `'performance', 'accessibility', 'best-practices', 'seo'`.

The performance category measures [**Core Web Vitals**](https://unlighthouse.dev/glossary) including [**LCP**](https://unlighthouse.dev/glossary/lcp), [**CLS**](https://unlighthouse.dev/glossary/cls), and [**INP**](https://unlighthouse.dev/glossary/inp).

It can be useful to remove certain categories from being scanned to improve scan times. The Unlighthouse UI will adapt to any categories you select.

**Only Performance**

```
export default defineUnlighthouseConfig({
  lighthouseOptions: {
    onlyCategories: ['performance'],
  },
})
```

[Edit this page](https://github.com/harlan-zw/unlighthouse/edit/main/docs/1.guide/guides/lighthouse.md)

[Markdown For LLMs](https://unlighthouse.dev/guide/guides/lighthouse.md)

**Did this page help you? **

Anything that could be done better? :)

Help us improve this page. You can [edit this page](https://github.com/harlan-zw/unlighthouse/edit/main/docs/1.guide/guides/lighthouse.md) on GitHub or provide anonymous feedback below.

[**Static Reports** Generate static Lighthouse reports for your entire site. Export as HTML, CSV, or JSON. Deploy to Netlify, CloudFlare, or any static host.](https://unlighthouse.dev/guide/guides/generating-static-reports) [**Puppeteer** Configure Puppeteer launch options for headless Chrome: --no-sandbox, Docker args, viewport, executable path, and navigation hooks. Copy-paste configs for CI and Docker.](https://unlighthouse.dev/guide/guides/puppeteer)

**On this page **

- [Aliases](#aliases)
- [Selecting Categories](#selecting-categories)