---
title: "Settings client"
slug: "settings-client"
abstract: "Use the Settings client to retrieve configuration settings or category IDs without writing custom queries."
---
# Settings client

The Settings client can be used to provide some extra utilities for retrieving settings.

Settings are entities that can be used with the Querying client and the Entities client. This client is useful because it provides common queries that would otherwise have to be written by hand.

## Get the category ID { .notintoc }

The following example snippet gets the ID of the *PortalConfiguration* category:

```csharp
long? id = await MClient.Settings.GetCategoryIdAsync("PortalConfiguration");

```

## Get a setting { .notintoc }

The following example retrieves a setting called *Authentication* from the *PortalConfiguration* category:

```csharp
IEntity setting = await MClient.Settings.GetSettingAsync("PortalConfiguration", "Authentication");

```

> [!note]
> You can pass an entity load configuration to the client.

## Get all the settings for a category { .notintoc }

You can also get all the settings for a category. For example, the following snippet gets all the rendition settings:

```csharp
IList IEntity renditionSettings = await MClient.Settings.GetSettingsForCategoryAsync("Renditions");

```

> [!note]
> You can pass an entity load configuration.