---
title: Warnings
description: >-
  Lightning warns users of possible misconfiguration, performance implications
  or potential mistakes through the PossibleUserWarning category.
canonical: 'https://lightning.ai/docs/pytorch/stable/reference/advanced/warnings'
---
# Warnings {#warnings}

Lightning warns users of possible misconfiguration, performance implications or potential mistakes through the `PossibleUserWarning` category.
Sometimes these warnings can be false positives, and you may want to suppress them to avoid cluttering the logs.

> **Warning**
>
> Suppressing warnings is not recommended in general, because they may raise important issues that you should address.
> Only suppress warnings if they are false.

## Suppress a single warning message {#suppress-a-single-warning-message}

Suppressing an individual warning message can be done through the `warnings` module:

```python
import warnings

warnings.filterwarnings("ignore", ".*Consider increasing the value of the `num_workers` argument*")
```

## Suppress all instances of PossibleUserWarning {#suppress-all-instances-of-possibleuserwarning}

Suppressing all warnings of the `PossibleUserWarning` category can be done programmatically

```python
from lightning.pytorch.utilities import disable_possible_user_warnings

# ignore all warnings that could be false positives
disable_possible_user_warnings()
```

or through the environment variable `POSSIBLE_USER_WARNINGS`:

```bash
export POSSIBLE_USER_WARNINGS=off
# or
export POSSIBLE_USER_WARNINGS=0
```

---

**Navigation**

- Parent: [Advanced](/docs/pytorch/2.6.6/reference/advanced.md)