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

# Managing Workspace Settings

> Configuration options for customizing your Validio installation.

Workspace settings let you configure system-wide options for your Validio environment, such as workspace display, default user roles, and your installation's application URL. Manage them under the **Workspace > Settings** tab.

![The Workspace Settings page with the workspace, default user, AI features, backfill, and catalog approval workflow settings](https://mintcdn.com/validio/a6QWStHa_xcWp5IO/images/docs/access-and-settings/1130-workspace-settings.png?fit=max\&auto=format\&n=a6QWStHa_xcWp5IO\&q=85\&s=1591e0b70e9c4f94e4502e4f5b0401db)

Workspace > Settings

> [!WARNING]
>
> Editing the workspace settings requires global `settings:WRITE` permissions. See [Managing Roles](https://docs.validio.io/docs/access-and-settings/settings/managing-roles.md).

## Workspace settings

Customize the Workspace settings in your Validio environment.

| Setting | Description |
| :- | :- |
| Display Name | An identifier for your Validio environment. |
| Application URL | The URL for your Validio installation or deployment instance. This setting is required for creating [notification channels](https://docs.validio.io/docs/integrations/notification-channels.md), sharing [links into your environment](https://docs.validio.io/docs/using-validio/deep-link-navigation.md), and [enabling AI features](https://docs.validio.io/docs/ai-features.md). |
| Upload Icon | Display your company logo, or a custom icon, on the Validio login and main application pages. |

## Default user settings

The default user settings allow you to streamline the initial setup process for users. You can set a default namespace and assign a default role, ensuring that newly created users have access to the correct workspace when they first log in.

| Setting | Description |
| :- | :- |
| Default Namespace | Set a namespace to automatically assign to all new users. |
| Default Role | Set a role to automatically assign to all new users. |

## AI features

The **AI features** settings let you enable AI-powered features and integrations on your Validio installation.

![The AI features settings with Allow LLM credentials and Enable MCP server selected, and the Summary settings for LLM credential, Schedule, and Run now](https://mintcdn.com/validio/a6QWStHa_xcWp5IO/images/docs/access-and-settings/1130-workspace-settings-ai-features.png?fit=max\&auto=format\&n=a6QWStHa_xcWp5IO\&q=85\&s=d0f2b3c57e64041c735c364b8e6399a3)

* **Allow LLM credentials** - Configure credentials for external Large Language Model (LLM) providers to compose and correct custom SQL queries in validators and filters. See [LLM Credentials](https://docs.validio.io/docs/integrations/llm-credentials.md).
* **Enable MCP server** - Integrate with the Validio MCP server. You will not be able to enable the MCP server if you do not set an Application URL for your Validio installation. Connected AI assistants inherit the permissions of the connecting user, and destructive operations are always refused. See [Validio MCP Server](https://docs.validio.io/docs/integrations/validio-mcp-server.md).

### Summary

The **Summary** settings control the written [Overview summaries](https://docs.validio.io/docs/ai-features/overview-summaries.md) of what changed in each reader's namespaces.

| Setting | Description |
| :- | :- |
| Schedule | When summaries are written: **No schedule** (the default), **Every day at 06:00**, **Every weekday at 06:00**, or **Every Monday at 06:00**. Times are in UTC. With **No schedule**, no summary is written on a schedule. |
| LLM credential | The [LLM credential](https://docs.validio.io/docs/integrations/llm-credentials.md) summaries are written with. With **None**, Validio writes a standard summary from templates instead. |

Click **Run now** to write summaries for every reader group right away.

## Backfill settings

Configure how backfilled incidents are handled in your Validio environment.

* **Auto-resolve backfilled incidents** — When enabled, incidents generated during a backfill (such as a validator reset, rerun, or initial start with backfill) are automatically resolved. Since resolved incidents are excluded from the [data quality score](https://docs.validio.io/docs/introduction/key-concepts.md#data-quality-score), this prevents historical reprocessing from negatively impacting your data quality metrics.

## Catalog approval workflow

Select **Require approval workflow for catalog changes** to require a second person to approve every change to business glossary terms, domains, classifications, catalog assets, and lineage edges before it takes effect. Keep this setting off if you manage the catalog through infrastructure as code (IaC). The setting cannot be cleared while catalog changes are still unsubmitted or in review. See [Catalog Approval Workflows](https://docs.validio.io/docs/access-and-settings/catalog-approval-workflows.md).

## Data quality thresholds

![The Data quality thresholds setting with a passing and warning threshold for each data quality dimension and for scores with no dimension](https://mintcdn.com/validio/a6QWStHa_xcWp5IO/images/docs/access-and-settings/1130-workspace-settings-dqthresholds.png?fit=max\&auto=format\&n=a6QWStHa_xcWp5IO\&q=85\&s=45fe346c273b672b80a9660fc9dc871b)

The Data quality thresholds setting controls the per-dimension passing/warning/failing bands used across the catalog — on the [glossary term data quality tab](https://docs.validio.io/docs/catalog/business-glossary.md#data-quality-tab), in classification coverage rollups, and in the data quality dots on the glossary list.

For each [data quality dimension](https://docs.validio.io/docs/validators/data-quality-dimensions.md) (Completeness, Validity, Timeliness, Accuracy, Consistency, Uniqueness), set:

* **Passing** -- The minimum score the dimension must reach to be considered passing. Scores at or above this value are reported as green.
* **Warning** -- The minimum score the dimension must reach to be considered warning. Scores at or above this value but below the passing threshold are reported as yellow. Scores below the warning threshold are failing (red).

Both thresholds are percentages between 0 and 100. The passing threshold must be greater than the warning threshold. Defaults follow common DAMA-aligned tolerances and can be tuned per workspace.

Threshold changes save immediately and apply the next time data quality scores are recalculated across the catalog.

## Diagnostic settings

Under the diagnostic settings, you can opt-out of tracking by third-party integrations.

* **Allow tracking of application usage** - Application usage allows Validio to track information about how you use our product and where you may have issues.
* **Allow collecting error logs** - Error logs allow us to track when our product has issues in your environment.