Skip to main content

Search the Commons

Type at least 2 letters. Use the arrow keys to move through results, Enter to open, Escape to close.

Ask a question instead: answers drawn from across the Commons, with links to the source. Or browse the site map.

Get started · User guide

How to use the Commons

You don't need to install anything or know how to code. Data you check stays in your browser. This guide covers the basics, every page, guided tours and common questions.

In short: a plain English summary
  • This page shows you how to use the website.
  • There are short tours you can follow step by step.
  • There are answers to common questions.

Quick start in 5 minutes

  1. On Home, choose your role or task.
  2. Press Take the tour at the top of any page for a walk-through. Escape leaves it.
  3. Open Check your data and run the example, or open your own CSV file. (The Python toolkit also reads Excel, ODS, JSON, Parquet, SQL databases and CKAN catalogues.)
  4. Read each rule's pass rate against its target, and the priority of anything that fails.
  5. Save the rules file so you can run the same checks next month, or in the pipeline.

Finding your way: colours, tables, tooltips and moving between pages

Colours that tell you where you are

Each part of the menu has its own colour: Start teal, Learn purple, Check blue, Improve orange, Apply green and Contribute pink. The colour is used on the menu, the label above each page title and the previous and next links. Sections on a page take turns with other colours, matched in the On this page list. Colour is always backed up by words, so you never need to see colour to use the Commons.

The site map

The site map shows every page on one screen, by part and level, with suggested routes for common tasks.

Easier tables

Columns are sized to what they hold: short codes stay narrow and long descriptions get more room. Rows are lightly striped. On large screens wide tables use the space beside the page. If a table is still wider than the screen, a shadow shows at its edge and a note tells you to scroll sideways. Long tables keep their headings in view.

Tooltips

Acronyms have a dotted underline the first time they appear on a page: hover over or tap one to see what it means. Buttons that only show an icon explain themselves when you hover over or tab to them. Press Escape to close a tooltip.

Progress, top and next

A thin bar under the top menu shows how far down the page you are. Top (bottom right) takes you back to the start. The end of every page links to the previous and next page in menu order.

Share, ask and reuse

Share this page sits under every page title. Ask the Commons answers questions from across the portal. Use the Commons your way explains embedding, the open data API, white-label copies, AI assistants and connectors.

Display options and source labels

Select Aa in the top bar to change the text size (up to 150%), widen line, letter and word spacing, switch to an easier-to-read font, choose light, dark or high contrast colours, reduce movement, and show or hide source labels. Your choices stay in this browser and apply to every page.

What the source labels mean

Every link to an outside source is followed by a small label saying what kind of source it is, so you can judge how far to rely on it:

The Commons' own judgements, such as mappings between frameworks or scores on the roadmap, are labelled in the text as the Commons' view. Facts marked verified have been checked at source by a person; a quarterly sample re-checks 5% of them.

Guided tours

Each link opens the page and starts its tour. Tours move focus to a small panel next to the part being explained. Use Next and Back, or the arrow keys, and Escape to stop.

Tutorials: step by step

Short tutorials for common jobs. Each one ends with a link that opens the page with its guided tour.

1. Find anything in under a minute

  1. Press / to search, or open the site map and type a word in its filter.
  2. Still not sure? Ask a question in your own words on Ask the Commons.
  3. On a long page, use On this page (bottom left) to jump to a section.

Start the site map tour

2. Share a page or section with a colleague

  1. Scroll to the section you want to share.
  2. Select Share this page under the page title.
  3. Choose Copy link to this section, or share by email, Teams or LinkedIn.

Try it on the playbook

3. Put a Commons page on your intranet

  1. Open the embed code builder.
  2. Pick the page and your accent colour; check the contrast message says it meets WCAG AA.
  3. Copy the code into an embed block on your intranet page. If nothing shows, ask your site owner to allow the Commons address.

Start the reuse tour

4. Use the Commons from an AI assistant

  1. Check your organisation has approved the assistant.
  2. Follow the MCP set-up steps on AI assistants, MCP and connectors.
  3. Ask it to cite the Commons page for each answer, and check the page before you act.

Or try Ask the Commons

5. Read a big table comfortably

  1. Open Catalogues and quality tools.
  2. Hover over a row to highlight it. Hover over an underlined acronym to see what it means.
  3. If there is a shadow at the right edge, scroll sideways (or hold Shift and use the mouse wheel).

Start the catalogues tour

6. Make your own branded copy

  1. Read the white-label route.
  2. Fork the repository, change the name and colours, and tailor the knowledge files.
  3. Build with one command and publish the folder it makes.

New to GitHub? Start here

Common tasks

Check a dataset

Go to Check your data. Open a CSV file or choose an example. Add rules from the rule builder, or start from the rule library: person, address, organisation, geography and publication templates. Press Run the checks.

Identifier checks test the format and, where there is one, the check digit: NHS number, National Insurance number, postcode, UPRN, GSS code, Companies House number, charity number, school URN, ODS code and LEI.

Find a standard and its status in government

Open the standards catalogue. Search by name or filter by domain and status. Each row links to the specification, the GOV.UK list, its Rosetta concepts, Weaver support and where it is used in public code.

Publish how complete your metadata is (DQV)

In the Metadata Weaver, paste a record and open the DQV (metadata quality) tab. Publish the result next to your DCAT record.

Continue in a sister portal

Open Three portals, one journey. Compare the portals, choose a box on the lineage map, or trace a DAMA area, role or standard through all three.

Find what a framework or policy expects

Go to Frameworks and standards. Filter by nation, sector or type. Open a framework to see its dimensions and how they map. The clause table breaks policies down line by line, with devolved and international comparisons and known gaps.

Assess your maturity

Go to Maturity self-assessment. For each of 8 themes, choose the statement that fits best. You'll get a level per theme and next steps. Your answers stay in your browser.

Prioritise issues

Use the calculator on Issues framework. Enter how important the purpose is and how bad the impact would be. It gives the target, the priority band and how quickly to fix.

See your whole data capability on the data management wheel

Open the data management wheel. Choose your role, then an area of the wheel, to see what it means for you, what to do for the DAM policy, where it shows up in maturity, and how records and information management fits in. If you have done the maturity self-assessment, tick Colour by my maturity results. Tick the join-up actions you will take and download your plan.

Run data quality through a programme or project

On For your role, pick your change role (for example SRO, delivery manager, business analyst, architect, migration lead or records manager). Use the lifecycle and gate questions at each assurance review, the RACI to agree who does what, and the service blueprint to plan the data and records work behind each phase.

Give feedback

Every page ends with a feedback link. Choose the Microsoft Form (no sign-in, no names), the GitHub contact form, a survey, or the accessibility route. All routes are on Help us build this.

Get value from AI safely

Read AI for data quality, then try the rules assistant, which runs in your browser with no AI service. Always review what it drafts: the page tests every draft against the kit before showing it.

Contribute, take a survey, or ask for help

Use Community for the contributions library and wishlist, and Surveys and commissions to take or run a survey or request help. If saving isn't available where you opened the portal, each form links to a GitHub form instead.

Automate checks every week

See Operating model and Pipeline status. The GitHub Actions pipeline measures every asset, keeps history, opens escalation issues and rebuilds this portal.

Questions

Is this official government guidance?

No. It's a prototype public good service. It links to official sources first and marks anything not yet verified.

Does my data get uploaded?

No. Checks run in your browser. Only things you choose to submit (a contribution, a survey answer, a request) are saved, and those never include your name or email unless you add a contact detail.

Is it only for the National Data Library or the DAM policy?

No. Those are two of the scenarios. The toolkit works for any data, and the Scenarios page covers statistics, health, local government, geospatial, personal data, AI and more.

Can we use the toolkit with our existing tools?

Yes. Rules are plain YAML and results are W3C DQV, CSV and JSON. See Tooling for routes into Great Expectations, R validate, Purview, Fabric and others, and the MCP server for AI agents.

How do I report a problem?

See the support tiers on Operating model. Accessibility problems are answered within 1 working day.

Accessibility

We aim to meet WCAG 2.2 AA. The portal works with a keyboard alone, screen readers, voice control and zoom up to 400%, follows your light or dark setting and respects reduced motion. Charts always have a table or text alternative.

Known gaps: the portal hasn't yet had an independent audit (planned, XDMH-213), and there is no Welsh version yet (XDMH-216). Tell us about anything that doesn't work for you through Surveys and commissions or the service desk.

Privacy