Skip to main content

# kater promotion admin levels

Shows where a shared model's own field can move up to.

{/* Written by apps/landing-page/scripts/docs/write_cli_reference.py from the kater CLI's own help and scripts/docs/cli-reference.md. Do not edit it by hand: change those, then run the script. */}

It lists each level above its model, nearest first, with what selecting it does. Without a field, it lists the model's fields that can move up.

## Examples

```bash
# List the fields of the Marketing Sessions model that can move up
kater promotion admin levels connections/snowflake_prod_connection/modeling/kater_objects/semantic_models/marketing/MARKETING_SESSIONS.sql
# Show where its is_identified field can move up to
kater promotion admin levels connections/snowflake_prod_connection/modeling/kater_objects/semantic_models/marketing/MARKETING_SESSIONS.sql is_identified
```

## Arguments

<div class="cli-options">

| Argument | Description |
| --- | --- |
| `<path>` | A shared model's file, from the content root, such as `connections/snowflake_prod_connection/modeling/kater_objects/semantic_models/marketing/MARKETING_SESSIONS.sql`. |
| `<field>` | Optional. One of the fields that the model defines itself, such as `is_identified`. Leave it out to list the fields that can move up. |

</div>

## Options

It also takes the [global options](https://kater.ai/docs/cli-reference/global-options/) `--json`, `--kater-root`, `--scope` and `--help`.

## When no field can move up

A model's field can move up only when the model defines it itself, and the model reads another shared model. When one of these is not true, Kater says that none of the model's fields can move up.

## See also

- [`kater promotion admin`](https://kater.ai/docs/cli-reference/promotion/admin/)
- [All commands](https://kater.ai/docs/cli-reference/kater/)

On this page

Examples
Arguments
Options
When no field can move up
See also

Kater CLI Present and share promotion admin

kater promotion admin levels

Shows where a shared model's own field can move up to.

It lists each level above its model, nearest first, with what selecting it does. Without a field, it lists the model’s fields that can move up.

Examples

# List the fields of the Marketing Sessions model that can move up
kater promotion admin levels connections/snowflake_prod_connection/modeling/kater_objects/semantic_models/marketing/MARKETING_SESSIONS.sql
# Show where its is_identified field can move up to
kater promotion admin levels connections/snowflake_prod_connection/modeling/kater_objects/semantic_models/marketing/MARKETING_SESSIONS.sql is_identified

Arguments

Argument	Description
`<path>`	A shared model’s file, from the content root, such as `connections/snowflake_prod_connection/modeling/kater_objects/semantic_models/marketing/MARKETING_SESSIONS.sql`.
`<field>`	Optional. One of the fields that the model defines itself, such as `is_identified`. Leave it out to list the fields that can move up.

Options

It also takes the global options --json, --kater-root, --scope and --help.

When no field can move up

A model’s field can move up only when the model defines it itself, and the model reads another shared model. When one of these is not true, Kater says that none of the model’s fields can move up.

See also