# Trunk Outbound Caller ID Parameters

When you export outbound caller ID entries from a trunk, Cloud Voice produces a CSV (comma-separated values) file with one column per setting. The same columns are read back when you import a file to create or update entries in bulk, which is the fastest way to set up many caller IDs at once instead of adding them one by one. Use the reference below to understand what each column controls, whether it is required, and how the value must be formatted.

## Column reference

### Create Method

Determines the type of outbound caller ID entry to create.

- **Required?** Yes
- **Accepted values:**
  - `single`, one shared outbound caller ID
  - `range`, a range of outbound caller IDs
- **Default:** `single`

:::note
Leave this column blank and Cloud Voice treats the row as `single`.
:::

### Short Code

A unique numeric code that pairs with the DOD (Direct Outward Dialing) prefix feature code so users can target a specific outbound caller ID, for example, to make a call with it or to set it as the default. DOD is the ability for an extension to present a chosen external number as its caller ID when dialing out.

- **Required?** No
- **Restrictions:** Digits only, up to 31 characters.
- **Default:** none

### Outbound Caller ID

The number presented to the person being called when the associated extensions dial out.

- **Required?** Yes
- **Restrictions:** For a single caller ID, you may use numbers, letters, the characters `[` `]` `(` `)` `.` `-` `+` `*` `#`, and the placeholder `{{.Ext}}`. Each caller ID may be up to 31 characters.
- **Default:** none

:::note
`{{.Ext}}` is a placeholder token for the associated extension's own number, so a single entry can apply to many extensions instead of hard-coding one number.
:::

For a caller ID range, the rules are stricter:

- Only digits and a leading `+` are allowed. Enter the first and last caller ID separated by a hyphen, such as `5503301-5503310`.
- The start and end values must contain the same number of digits, and either both include a `+` or neither does. A single range cannot span more than 500 numbers.
- Populate **Associated Extensions** with a matching extension range; the caller ID range and the extension range must contain the same count of numbers.

:::caution
A caller ID range and its extension range must line up exactly, or the import fails. Keep the same digit count on the start and end numbers, apply `+` to both ends or neither, stay within 500 numbers per range, and make the extension range hold the same number of entries as the caller ID range.
:::

### Outbound Caller ID Name

The name shown to the called party alongside the number for the associated extensions.

- **Required?** No
- **Restrictions:** Up to 127 characters.
- **Default:** none

### Default DOD Label

The label that appears by default when an extension user chooses which DOD (Direct Outward Dialing) number to dial out with.

- **Required?** No
- **Restrictions:** Up to 127 characters.
- **Default:** none

### Associated Extensions

The extensions tied to this outbound caller ID and caller ID name.

- **Required?** Yes
- **Accepted values:** one or more extension numbers or extension group names that already exist in the system.
  - Separate multiple extensions or groups with an ampersand (`&`), for example `{extension_number1}&{extension_number2}&{extension_group_name3}`.
  - To specify a range, enter the first and last extension number separated by a hyphen, such as `1001-1010`. Each number may be up to 11 digits.
- **Default:** none

:::caution
Any extension number or group name that does not already exist in the system is skipped silently during import, with no error. Confirm every extension and group exists first, then check the imported entries afterward so you do not assume a caller ID was applied when it was quietly dropped.
:::
