> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

#  

# `prefect profiles`

```command theme={null}
prefect profiles [OPTIONS] COMMAND [ARGS]...
```

> [!NOTE]
>
> Select and manage Prefect profiles.

## `prefect profiles ls`

```command theme={null}
prefect profiles ls [OPTIONS]
```

> [!NOTE]
>
> List profile names.

> **Options**
>
> **--output**
>
> Specify an output format. Currently supports: json

## `prefect profiles create`

```command theme={null}
prefect profiles create [OPTIONS] NAME
```

> [!NOTE]
>
> Create a new profile.

> **Arguments**
>
> **NAME** `string` *required*

> **Options**
>
> **--from**
>
> Copy an existing profile.

## `prefect profiles use`

```command theme={null}
prefect profiles use [OPTIONS] NAME
```

> [!NOTE]
>
> Set the given profile to active.

> **Arguments**
>
> **NAME** `string` *required*

## `prefect profiles delete`

```command theme={null}
prefect profiles delete [OPTIONS] NAME
```

> [!NOTE]
>
> Delete the given profile.

> **Arguments**
>
> **NAME** `string` *required*

## `prefect profiles rename`

```command theme={null}
prefect profiles rename [OPTIONS] NAME NEW_NAME
```

> [!NOTE]
>
> Change the name of a profile.

> **Arguments**
>
> **NAME** `string` *required*
>
> **NEW\_NAME** `string` *required*

## `prefect profiles inspect`

```command theme={null}
prefect profiles inspect [OPTIONS] [NAME]
```

> [!NOTE]
>
> Display settings from a given profile; defaults to active.

> **Arguments**
>
> **NAME** `string`
>
> Name of profile to inspect; defaults to active.

> **Options**
>
> **--output**
>
> Specify an output format. Currently supports: json

## `prefect profiles populate-defaults`

```command theme={null}
prefect profiles populate-defaults [OPTIONS]
```

> [!NOTE]
>
> Populate the profiles configuration with default base profiles,
> preserving existing user profiles.