# PytestUnknownMarkWarning: Unknown pytest.mark.smoke - is this a typo?

- **ID:** `python/pytest-marks-unknown-warning`
- **Domain:** python
- **Category:** config_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

A custom marker like @pytest.mark.smoke is used but not registered in pytest configuration, so pytest warns it is unknown. With strict markers enabled, this becomes an error.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 7.x | active | — | — |
| 8.x | active | — | — |

## Workarounds

1. **** (95% success)
   ```
   Register markers in pytest.ini:

[pytest]
markers =
    smoke: quick smoke tests
    slow: long-running tests
   ```
2. **** (93% success)
   ```
   Or in pyproject.toml:

[tool.pytest.ini_options]
markers = [
  'smoke: quick smoke tests',
]
   ```

## Dead Ends

- **** — Suppressing the warning does not register the marker; `pytest -m smoke` still fails to select tests. (85% fail)
- **** — This changes test semantics and does not provide the intended selection behavior. (80% fail)