---
title: "Custom Tags in CDR Reports"
slug: "custom-tags-in-cdr-reports"
description: "The custom tag field on Call Detail Records (CDRs) is populated from the optional X-Tag SIP header field, which you can specify on each outbound call."
tags: ["Custom Tag", "CDR", "Asterisk", "FreeSwitch", "pbx"]
updated: 2026-02-25T04:42:12Z
published: 2026-02-25T04:42:12Z
canonical: "support.bcmone.com/custom-tags-in-cdr-reports"
---

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

# Custom Tags in CDR Reports

> [!WARNING]
> **IMPORTANT**: Details in this document are for reference only and are unsupported by the Flowroute support staff. Please use as purely reference material; we make no guarantees that this information is correct, or will not harm your system. Please be careful and always keep a backup of anything before you make changes, or alter settings.

#### Custom Tag

The **custom tag** field on Call Detail Records (CDRs) is populated from the optional X-Tag SIP header field, which you can specify on each outbound call. The maximum length you may use for this field is 32 characters; anything longer will be truncated. You can populate the contents of the custom tag dynamically using variables if you're a savvy user for your respective system. This allows you to tag CDRs with your internal customer IDs, calling campaigns, etc.

This article describes creating custom tags for **Asterisk**, **and** **FreeSWITCH**.

#### **Asterisk**

Add the following line to your dial plan before the Dial() command to tag your calls with a custom tag. In the following example, *bob* is added as a custom tag. `SIPAddHeader(X-Tag: bob)`

#### **FreeSWITCH**

Add the following to your dial plan XML for outbound calls to add the custom tag. In the following example, *bob* is added as a custom tag. `sip_h_X-Tag=bob`

For inbound calls, add the following for the custom tag. In the following example, *bob* is added as a custom tag. `sip_rh_X-Tag=bob`

> **NOTE:** Additional information regarding the channel variable can be found on FreeSWITCH's [Channel Variables](https://freeswitch.org/confluence/display/FREESWITCH/Channel+Variables) wiki page.

## Related

- [Call Detail Record (CDR) Reports](/call-detail-record-cdr-reports.md)
- [How Do I Set Up DID Alias?](/how-do-i-setup-did-alias.md)