> For the complete documentation index, see [llms.txt](https://raia-software-inc.gitbook.io/tacview-2-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://raia-software-inc.gitbook.io/tacview-2-documentation/api-reference/api-reference/telemetry/clear-telemetry.md).

# ClearTelemetry()

Clears the telemetry currently loaded in Tacview.

## Syntax

```lua
ClearTelemetry()
```

## Parameters

This function has no parameters.

## Return value

This function does not return a value.

## Remarks

`ClearTelemetry()` cancels and waits for any pending telemetry import or export operation to complete, then purges the telemetry data currently loaded in the session.

It also clears the current telemetry document name and file type.

This function only clears dynamic telemetry data. It does not clear temporary database entries or static objects.

Use this function when an add-on needs to reset the current telemetry session before loading new telemetry, or when it provides a command to close the current telemetry document.

After telemetry has been cleared, functions that depend on loaded telemetry may return `nil`, `false`, or empty results until new telemetry is loaded.

## Example

```lua
if WasMenuItemClicked(mainMenuHandle, CloseDocumentCommandId) then

	ClearTelemetry()

end
```

This closes the current telemetry document and clears the telemetry loaded in the session.

## See also

* [LoadTelemetry()](/tacview-2-documentation/api-reference/api-reference/telemetry/load-telemetry.md)
* [IsTelemetryEmpty()](/tacview-2-documentation/api-reference/api-reference/telemetry/is-telemetry-empty.md)
* [IsTemporalTelemetryAvailable()](/tacview-2-documentation/api-reference/api-reference/telemetry/is-temporal-telemetry-available.md)
* [GetTelemetryDocumentName()](/tacview-2-documentation/api-reference/api-reference/telemetry/get-telemetry-document-name.md)