---
title: Use field aliases
slug: q1k90356
canonical_url: https://docs.coveo.com/en/q1k90356/
collection: build-a-search-ui
source_format: adoc
---
# Use field aliases
Use [field aliases](https://docs.coveo.com/en/q1q94008/) to access multiple [dictionary field](https://docs.coveo.com/en/2036/) keys in a single query request.
This is useful when you need to retrieve several values from the same dictionary field at once, which isn't possible with the [`dictionaryFieldContext`](https://docs.coveo.com/en/56#dictionaryfieldcontext-object-optional) parameter.
For example, in a commerce scenario, you can display both the regular price and a discounted price for a product in the same result.
With `dictionaryFieldContext`, you would have to choose one.
With [field aliases](https://docs.coveo.com/en/q1q94008/), you can retrieve both values simultaneously.
You can also use [field aliases](https://docs.coveo.com/en/q1q94008/) like non-dictionary fields in advanced query expressions (`aq`) for filtering and in [ranking functions](https://docs.coveo.com/en/237/) for boosting.
## Example scenario
Suppose your [index](https://docs.coveo.com/en/204/) contains products with a `price_list` dictionary field that stores different prices for different customer types:
```json
{
"documentId": "product://alternator-001",
"title": "Mercury Alternator",
"price_list": {
"regular": 4000.00,
"vip": 3750.00,
"wholesale": 3500.00
}
[...]
}
```
With `dictionaryFieldContext`, you can only retrieve one of these prices per query.
.`dictionaryFieldContext` example
Details
```json
// Token
{
"dictionaryFieldContext": { "price_list": "vip" }
}
// Query - uses original field name
{
"q": "boots"
}
// Response - only one price available
{
[...]
"results": [
{
[...]
"raw": {
[...]
"price_list": 3750.00
}
}
]
}
```
Details
```json
// Token
{
"allowedDictionaryFieldKeys": { "price_list": ["*"] }
}
// Query - uses custom alias names
{
"fieldAliases": {
"regular_price": "price_list.regular",
"vip_price": "price_list.vip"
},
"q": "boots"
}
// Response - multiple prices available via aliases
{
[...]
"results": [
{
[...]
"raw": {
[...]
"regular_price": 4000.00,
"vip_price": 3750.00
}
}
]
}
```