---
title: Languages
summary: 'A language is a spoken-language label attached to users, so the routing layer can target "someone who speaks French".'
section: features
tags:
  - crud
  - telephony
  - attributes
updated: '2026-08-12'
---

> A **language** is a spoken-language label attached to users, so routing can ask for *"someone who speaks French"* and reach a person who can hold the conversation. Each user can carry several at once.

## Overview

A language is the linguistic dimension of your tenant, sitting alongside [Tags](tags.md) and [Locations](locations.md) as a per-user attribute. You pick a name from a predefined list, then assign the users who speak it. Each user can carry multiple languages.

## What it does

Language assignments shape **who picks up** a call. A caller who selects French in an IVR menu can be routed to a French-speaking queue, but never sees the assignment itself. Languages become routing-relevant when consumed by:

- **Pools** - both Include and Filter phases accept languages, for example *"all sales agents who speak French"*.
- **Multicasts** - page everyone who speaks a given language.
- **Call flow steps** - the *Dial* step type can target users by language.
- **Queues** - via a language-filtered pool member source.

The **Name** is read-only after creation. To change a language, delete and recreate it, then re-assign the users.

> [!TIP]
> Combine a language with a tag in a pool's Filters for finer routing, for example *"speaks French AND has the senior tag"*.

## See also

- [Users](users.md) - where languages are assigned.
- [Pools](pools.md) - the main consumer.
- [Multicasts](multicasts.md) - paging by language.
- [Tags](tags.md) - the attribute-based counterpart.
- [Locations](locations.md) - the place-based counterpart.

```yaml fields
name:
  label: Name
  api: name
  tab: General
  hint: 'The language name, selected from a predefined list. Cannot be changed after creation.'
users:
  label: Users
  tab: General
  hint: 'Users who speak this language. These users can be targeted by language-based call routing in call flows and pools.'
```