# DeviceAtlas Device Detection API Config #
Device Detection API Config provides options to customize the way the API
behaves in terms of device properties.
## Contents ##
* [da_config_t](#config)
* [How it works](#how_it_works)
### da_config_t ###
* [Include User-Agent properties](#include_ua_props)
* [Include language properties](#include_lang_props)
#### Include User-Agent properties ####
Boolean value to enable/disable the addition of User-Agent properties to the
detection. They are also known as "dynamic" properties as they can be detected
on the fly by directly parsing the User-Agent.
Enabling this property will reduce API detection performance. If dynamic properties
are not needed, set it to `False`.
User-Agent/Dynamic properties: `browserName, browserVersion,
browserRenderingEngine, osName, osVersion`
**Config property:**
`da_config_t.ua_props`
**Possible values:** True/False
**Default Value:** True
#### Include language properties ####
Boolean value to enable/disable the addition of client's language and locale
preferences to the device property set.
If these properties are not needed, it should be set to FALSE.
Language properties: `language, languageLocale`
**Config property:**
`da_config_t.lang_props`
**Possible values:** True/False
**Default Value:** True
### How it works ###
This section describes how to use the `da_config_t` instance to
modify the behavior of the `da_atlas_t` instance
when performing the device properties lookup.
#### Use of the default settings ####
When a new instance of a `da_atlas_t` is initialized,
internally another instance of the `da_config_t` class is generated
with the default settings.
#### Use of custom settings ####
In order to use custom settings, it is required to explicitly create a
`da_config_t` instance, set the settings and pass it to the `da_atlas_t` instance.
```c
da_config_t config;
config.ua_props = 0; // Bypass the dynamic properties, if not part of the expected property set, boosting the performance.
config.lang_props = 0; // Bypass the language and locale properties.
da_atlas_setconfig(&atlas, &config);
```
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
_ Copyright (c) DeviceAtlas Limited 2021. All Rights Reserved. _
_ https://deviceatlas.com _