[Introduction](https://verity.md/docs) [Quickstart](https://verity.md/docs/quickstart) [Authentication](https://verity.md/docs/authentication) [How it works](https://verity.md/docs/how-it-works) [Moments](https://verity.md/docs/moments) [Formal verification](https://verity.md/docs/formal) [Findings & verdicts](https://verity.md/docs/findings) [The Standard](https://verity.md/docs/standard) [Org Standards](https://verity.md/docs/org-standards) [Standards on the web](https://verity.md/docs/web-standards) [The terminal editor](https://verity.md/docs/terminal-editor) [Memory](https://verity.md/docs/memory) [Org knowledge](https://verity.md/docs/org-knowledge) [Token telemetry & cost](https://verity.md/docs/cost) [The dashboard](https://verity.md/docs/dashboard) [CLI & commands](https://verity.md/docs/cli) [Files & configuration](https://verity.md/docs/files) [Security & privacy](https://verity.md/docs/security) [Troubleshooting](https://verity.md/docs/troubleshooting)

Concepts

# Standards on the web

Read and change a repository's Standard and your org's Standard at verity.md. Every save is one new version, with its author, and any version can be restored.

## Where to find them

Sign in at [verity.md](https://verity.md/login). The sidebar has two sections:

- **Repository › Standard**: the Standard of the repository you opened.
- **Org › Org Standards**: the orgs you belong to, each with its org Standard version and your role in it. Open one to see its Standard. The item shows when you belong to at least one org.

Your own pages are in the account menu, under your email at the bottom of the sidebar: Repositories, Devices, Agents, Billing and Docs.

## A repository's Standard

The page lists every rule, with its severity, what it found in the last 30 days, and what happens when it finds something: **Block**, **Warn** or **Off**. When the repository belongs to an org with an org Standard, the top of the page names it, with its org rules and the rules the org made mandatory.

**Block** lets a high or critical finding of the rule stop the commit or push. **Warn** shows it and never blocks. **Off** stops the rule. Warn and Off apply to what the reviewer reports. A finding that a static tool saw, such as a secret that Trivy found in the change, still blocks as before. To accept one such risk, use `verity waive`.

- Filter by name or by what a rule says, by Block, Warn, Off or Locked, by review pack, or **Noisy only**: rules with 2 or more false-positive votes in the last 30 days.
- Change what happens or the severity on the row. A locked row shows `set by acme` and has no controls.
- Your changes wait in a tray. **Review** shows them, and the review page saves them together as one new version.
- When someone saves a version in the terminal or in another tab, an open page says so within 30 seconds.

The Standard of acme/shop. The org rule is locked: it says set by acme and has no controls.

A change waits in the tray at the bottom until you review and save it.

### One rule

Open a rule to see how it is built here: the catalogue, the org layer, and this repository.

- **Edit the rule** shows for your team's own rules, also rules that `verity init` wrote. Change the title, the rule text and the paths it applies to. **Keep the edit** adds it to your changes.
- **Make it your own** shows for catalogue rules and org rules. Their text is shared, so you add to them: a **case** the rule must also find here, an **example**, or a **near miss** that is fine here.
- On a rule the org locked, you can add a case or an example only.
- **Try it** runs the rule on code you paste. Nothing you paste is stored.
- The page also lists the changes that named this rule, and Verity's proposals for it, to approve or reject.

One catalogue rule: how it is built here, the case this repository added, and Try it.

### A new rule

**New rule**: describe it in plain words, from a finding, or from a bad example. **Draft the rule** asks Verity to write it: the title, the rule, the evidence a finding must show, examples, the paths, the category, what happens and the severity. A draft is at most medium: a higher severity is your choice. You can change every field. When the draft overlaps a rule you already have, choose **Extend that rule instead** or **Keep a separate rule**. Try it on its examples and on code you paste, then **Review and save**.

### Review and history

The review page lists the waiting changes. You can drop one, then save the rest as one new version. Below them are the versions, newest first, each with its author and where it was made (on the web, in the terminal, or by an agent). **What changed** shows the difference. **Restore** brings back an earlier version as a new version: nothing is deleted.

One change to review, and every version of the Standard with its author. Any version can be restored.

Suggested rules start in the terminal

**Suggest rules** on the Standard page explains it: Verity writes rules from a profile of your checkout, and the web has no checkout. Run `verity standard suggest` in the repository, or press `g` in `verity standard edit`. The rules you keep show here. See [The terminal editor](https://verity.md/docs/terminal-editor).

## An org's Standard

**Org Standards**, then an org. The top of the page says your role and what it lets you do: org admin, org editor, or member. [Org Standards](https://verity.md/docs/org-standards) explains the roles and the locks.

- **The rules**: severity and what happens, as on a repository's page.
- **Mandatory**: org admins switch a rule between Default and Locked. A locked rule cannot be changed in any repository of the org.
- **Changed in**: the repositories that changed the org's default for a rule, and to what.
- **Who can change it**: the org admins and the org editors. An org admin gives the editor role to a member, or takes it.
- **Repositories**: the repositories that build on it, with how many defaults each changed.
- **History** and **New org rule** work as on a repository's page. Only org admins restore an earlier org version.

The acme org Standard, as an org admin sees it: an org rule and a catalogue rule are locked, and one rule keeps its default.

### Waives

Org admins see a **Waives** button on the org Standard. It lists every waive in the org's repositories, newest first: when, who (and whether an agent or a terminal made it), the repository, the rule, the file and the reason. A lock mark shows a waive of a rule the org had locked, and **Locked rules only** filters to those. Anyone else who opens the page is told that only org admins see the waives.

Every waive in the repositories of acme, newest first, with its account, rule, file and reason.

What the web cannot do

The web cannot suggest rules, and an org Standard has no file to pull. The terminal cannot restore a version, add an example, choose org editors, or show the waives: those are on the web.

[Previous Org Standards](https://verity.md/docs/org-standards) [Next The terminal editor](https://verity.md/docs/terminal-editor)

Source: https://verity.md/docs/web-standards
