---
title: "Custom reports registration"
manual: "Reports"
version: "13.4"
permalink: "https://docs.typo3.org/permalink/typo3/cms-reports:custom-reports@13.4"
source: "CustomReports/Index.rst"
rendered: "2026-10-09T09:32:18+00:00"
---

# Custom reports registration {#custom-reports}

The only report provided by the TYPO3 core is the one
called **Status**.

The status report itself is extendable and shows status messages like a system
environment check and the status of the installed extensions.

Reports and status are automatically registered through the service
configuration, based on the implemented interface.

## Register a custom report {#register-custom-report}

All reports have to implement the interface
[\\TYPO3\\CMS\\Reports\\ReportInterface](https://docs.typo3.org/permalink/typo3/cms-reports:typo3-cms-reports-reportinterface@13.4).
This, way, the report is automatically registered if `autoconfigure`
is enabled in `Services.yaml`:

**EXT:my_extension/Configuration/Services.yaml**

```yaml
services:
  _defaults:
    autoconfigure: true
```

Alternatively, one can manually tag a custom report with the
`reports.report` tag:

**EXT:my_extension/Configuration/Services.yaml**

```yaml
Vendor\MyExtension\Report\MyReport:
  tags:
    - name: reports.report
```

## Register a custom status {#register-custom-status}

All status providers must implement
[\\TYPO3\\CMS\\Reports\\StatusProviderInterface](https://docs.typo3.org/permalink/typo3/cms-reports:typo3-cms-reports-statusproviderinterface@13.4).
If `autoconfigure` is enabled in `Services.yaml`,
the status providers implementing this interface will be automatically
registered.

Alternatively, one can manually tag a custom report with the
`reports.status` tag: