> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a Data Source

> Remove a Data Source from Reporter when no live Template depends on its database connection.

Use this page to remove a Data Source that should no longer be available for future Templates or Reports.

## Objective

***

Remove a Data Source connection from Reporter.

For example, delete a Data Source when an external reporting database was retired. Delete it when a temporary migration connection is no longer necessary, or when operators have moved to a replacement connection.

## When to use

***

Use this task when:

* you retired the database connection
* no current Template or reporting process should use it
* a replacement Data Source exists, if the process continues
* the connection exists by mistake and should not remain available

Do not delete a Data Source just because it is not part of the current operator journey. Internal product Data Sources may be preconfigured for other Templates or future Reports.

Do not delete a Data Source just because a connection test failed. If you still need the connection, edit and test it instead.

## Before you start

***

Confirm:

* no active reporting process depends on the connection
* current Templates do not rely on fields from this Data Source
* operators know which replacement Data Source to use
* the connection does not fail only temporarily because of credentials, network, schema, or SSL settings

<Danger>
  Reporter refuses to delete a Data Source that a live Template still references. Update or delete those Templates first.
</Danger>

## Step by step

***

<Steps>
  <Step title="Open Data Sources">
    Go to **Data Sources**.
  </Step>

  <Step title="Find the connection">
    Locate the card for the Data Source you want to delete.
  </Step>

  <Step title="Open the delete action">
    Click the three vertical dots (<Icon icon="ellipsis-vertical" />) on the card and select **Delete**.
  </Step>

  <Step title="Confirm deletion">
    In the **Delete Connection** dialog, review the connection name and confirm the deletion.
  </Step>

  <Step title="Check the list">
    Confirm that the Data Source no longer appears on the **Data Sources** page.
  </Step>
</Steps>

## Field guide

***

| Field or label        | What to check                                                                                                                                   | Example                                         |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| Connection name       | Confirms the Data Source that will be removed. The technical field is `configName`; check that it is the retired connection, not a replacement. | `migration-postgres-temp`                       |
| Data source ID        | Technical UUID used by the API as the `dataSourceId` path parameter.                                                                            | `018f2f4c-...`                                  |
| **Delete**            | Action in the Data Source card menu. It starts the destructive flow and opens the confirmation dialog.                                          | Select **Delete** on `migration-postgres-temp`. |
| **Delete Connection** | Final confirmation action. After this, the Data Source is removed from the active **Data Sources** list.                                        | Confirm the temporary connection removal.       |

## Expected result

***

The Data Source disappears from the active list. Reporter only completes the deletion after no live Template references the connection.

## Common errors and care points

***

<AccordionGroup>
  <Accordion title="Deleting a connection still used by Templates">
    Reporter blocks the deletion when a live Template references the connection. Update or delete those Templates first.
  </Accordion>

  <Accordion title="Deleting instead of fixing credentials">
    If your operation still needs the connection, edit credentials or SSL settings and run **Test Connection**.
  </Accordion>

  <Accordion title="Deleting without a replacement">
    If the reporting process continues, create and test the replacement Data Source before deleting the old one.
  </Accordion>
</AccordionGroup>

## Next steps

***

* Use [Add a Data Source](/en/products/reporter/console/adding-a-data-source) if you need a replacement connection.
* Use [Test a Data Source Connection](/en/products/reporter/console/testing-a-data-source) to validate replacement connections.
* Use [Managing Data Sources](/en/products/reporter/console/managing-data-sources) to review the remaining active connections.
