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

# Tyk Governance Quick Start

> Create your first governance ruleset from a template, scope it to an API Category, then read and fix your first compliance issue.

This tutorial takes you end to end through Tyk Governance: you create a ruleset from a shipped template, scope it to an API Category, read the compliance result it produces on a service, and fix one issue.

It covers both governance roles, so work through it once even if only one half is your job. It should take about ten minutes.

## Before You Start

You need:

* Tyk Governance enabled on your organization's license. It is off by default and is not self-service. See [Availability and Licensing](/docs/tyk-governance/overview#availability-and-licensing).
* **Write** access on the Rulesets Governance permission group, to create a ruleset. See [Roles and Access](/docs/tyk-governance/core-concepts#roles-and-access).
* At least one Tyk OAS API in Tyk Dashboard, tagged with an API Category you can use for this walkthrough.

## Instructions

### Step 1: Open the Rulesets Section

From the left navigation, expand **Governance** and click **Rulesets**. If no rulesets exist yet, the empty state guides you to create your first one.

<img src="https://mintcdn.com/tyk/RyutBiXvT7zqmxQJ/img/governance/Ruleset1.png?fit=max&auto=format&n=RyutBiXvT7zqmxQJ&q=85&s=748c5d8e84e49fb3f0c1293e4ebc8808" alt="Governance navigation menu showing the Rulesets section in Tyk Dashboard" width="3010" height="1576" data-path="img/governance/Ruleset1.png" />

### Step 2: Create a New Ruleset

Click **+ Create new ruleset**. The three-step creation wizard opens.

<img src="https://mintcdn.com/tyk/RyutBiXvT7zqmxQJ/img/governance/Ruleset2.png?fit=max&auto=format&n=RyutBiXvT7zqmxQJ&q=85&s=9f4f19bdc6e9d3fbe9dbabca3ed9b423" alt="Rulesets empty state with the Create new ruleset button" width="3000" height="1580" data-path="img/governance/Ruleset2.png" />

### Step 3: Add Basic Information and Scope It

Provide a name and description for your ruleset. Link the ruleset to one or more API Categories so it knows which services to evaluate. Leave the Deployment Warning toggle off for now, which is the default.

This category link is how a ruleset finds its services. Any service tagged with a matching category is evaluated against this ruleset automatically. For the full model, see [Scoping Rulesets to Services](/docs/tyk-governance/scoping-rulesets).

<img src="https://mintcdn.com/tyk/RyutBiXvT7zqmxQJ/img/governance/Ruleset3.png?fit=max&auto=format&n=RyutBiXvT7zqmxQJ&q=85&s=734bfa9666fad554a9ffc8d4afca5954" alt="Create ruleset wizard, Basic Info step with name, description, categories, and Deployment Warning toggle" width="3010" height="1572" data-path="img/governance/Ruleset3.png" />

### Step 4: Start From a Template

Choose **Start from template**. This lists the templates available in your environment.

<img src="https://mintcdn.com/tyk/RyutBiXvT7zqmxQJ/img/governance/Ruleset4.png?fit=max&auto=format&n=RyutBiXvT7zqmxQJ&q=85&s=dfcbe3478f342c6468ec3e402ad6eb56" alt="Create ruleset wizard, choosing a starting point" width="3000" height="1574" data-path="img/governance/Ruleset4.png" />

For this tutorial, choose **OWASP API Security** for a security baseline, then click **Continue**.

<img src="https://mintcdn.com/tyk/RyutBiXvT7zqmxQJ/img/governance/Ruleset5.png?fit=max&auto=format&n=RyutBiXvT7zqmxQJ&q=85&s=bb499873157ca12062f0e2e0b6446fca" alt="Create ruleset wizard, template selection" width="3008" height="1572" data-path="img/governance/Ruleset5.png" />

### Step 5: Review the Definition and Activate

The selected template's JSON loads into the editor. You can disable individual rules, adjust severities, or modify rule definitions before continuing.

<img src="https://mintcdn.com/tyk/RyutBiXvT7zqmxQJ/img/governance/Ruleset6.png?fit=max&auto=format&n=RyutBiXvT7zqmxQJ&q=85&s=e07b0adc69469c9df4faed7912728a5b" alt="Create ruleset wizard, raw definition editor showing the selected template's JSON" width="2996" height="1580" data-path="img/governance/Ruleset6.png" />

Click **Save**. Two options are offered:

* **Save as draft**: saves without activating. It does not evaluate any services.
* **Save and activate**: evaluates every service in the linked categories.

Choose **Save and activate**. You are redirected to the ruleset's detail page.

<img src="https://mintcdn.com/tyk/RyutBiXvT7zqmxQJ/img/governance/Ruleset7.png?fit=max&auto=format&n=RyutBiXvT7zqmxQJ&q=85&s=1c499a54cdef3416616bc311730ed9b4" alt="Ruleset detail page after creation, showing configuration and test panel" width="3014" height="1580" data-path="img/governance/Ruleset7.png" />

**Check your work:** the ruleset appears in the Rulesets list with status **Active**, and services tagged with the linked categories begin to be evaluated in the background.

### Step 6: Read Your First Compliance Result

Open one of the APIs tagged with the category you linked, then switch to the **Governance** tab. It is the last tab in the API details page.

<img src="https://mintcdn.com/tyk/RyutBiXvT7zqmxQJ/img/governance/Evaluation2.png?fit=max&auto=format&n=RyutBiXvT7zqmxQJ&q=85&s=ed9c1e8068281e473447bed32b1c553e" alt="Governance tab on a service" width="1705" height="884" data-path="img/governance/Evaluation2.png" />

Read the status banner at the top. It shows **Compliant** if the service has no Error-severity issues, or **Non-compliant** if it has at least one, with counts of errors and warnings aggregated across every ruleset evaluating the service.

Below the banner, the Rulesets card grid shows each ruleset evaluating this service, and the Issues table lists each individual rule failure.

<img src="https://mintcdn.com/tyk/RyutBiXvT7zqmxQJ/img/governance/Evaluation3.png?fit=max&auto=format&n=RyutBiXvT7zqmxQJ&q=85&s=4d558bec53729b28a3fb5f4ffa08710e" alt="Governance tab issues table" width="1700" height="884" data-path="img/governance/Evaluation3.png" />

### Step 7: Fix One Issue

Click **View issue** on any row to open the issue details.

<img src="https://mintcdn.com/tyk/RyutBiXvT7zqmxQJ/img/governance/Evaluation4.png?fit=max&auto=format&n=RyutBiXvT7zqmxQJ&q=85&s=00f23ae09907347edc313d2ea23ae027" alt="Issue details panel" width="1697" height="878" data-path="img/governance/Evaluation4.png" />

Each issue names the rule that failed, the affected area in the service specification, the problem if it is left unfixed, and concrete "How to fix" guidance.

Use the affected-area path to find the setting in the API Designer, apply the fix, and save the service. Saving triggers a re-evaluation, and the Governance tab updates with the new status, usually within a second.

## Next Steps

Now that governance is running, follow the track that matches your role:

**If you define standards** (platform teams and governance leaders):

* [Rulesets](/docs/tyk-governance/rulesets): create rulesets from your own definitions, configure existing ones, and test before activating.
* [Ruleset Templates](/docs/tyk-governance/ruleset-templates): what each shipped template enforces.
* [Scoping Rulesets to Services](/docs/tyk-governance/scoping-rulesets): scoping patterns, and why a service is or is not being evaluated.

**If you satisfy standards** (API developers and service owners):

* [Service Compliance](/docs/tyk-governance/service-compliance): the full anatomy of the Governance tab and the portfolio view.
* [Remediate Issues](/docs/tyk-governance/remediate-issues): prioritize by severity, and handle the Deployment Warning.
* [CI/CD Governance Checks](/docs/tyk-governance/cicd-checks): run the same checks on a spec in your pipeline, before it is ever imported.
