homepage/docs/widgets/services/paperlessngx.md

---
title: Paperless-ngx
description: Paperless-ngx Widget Configuration
---

Learn more about [Paperless-ngx](https://github.com/paperless-ngx/paperless-ngx).

Use username & password, or the token key. Information about the token can be found in the [Paperless-ngx API documentation](https://docs.paperless-ngx.com/api/#authorization). If both are provided, the token will be used.

Allowed fields: `["total", "inbox"]`.

```yaml
widget:
  type: paperlessngx
  url: http://paperlessngx.host.or.ip:port
  username: username
  password: password
```

```yaml
widget:
  type: paperlessngx
  url: http://paperlessngx.host.or.ip:port
  key: token
```