# Esmond AI policy register: data dictionary

Version 2026.11.8 (2026-11-20). Licence: CC BY 4.0, except the column `quote`. The column quote contains short quotations from the institutions' own published rules, included under the quotation exception (Art. 5(3)(d) Directive 2001/29/EC; Belgian Code of Economic Law, Art. XI.189). They are not licensed under CC BY 4.0; rights remain with the institutions. Encoding UTF-8, comma-separated, first row is the header. An empty cell means: not applicable or not recorded. In the JSON files the same fields carry real types (true/false, numbers, null for an empty date).

## alle.csv, alle.json and one file per register (one record per institution)

| column | type | definition | values | example | legacy name |
|---|---|---|---|---|---|
| `id` | string | Stable identifier of the record. Never reused, also after a record is withdrawn. |  | `be-ugent` | `id` |
| `register` | string | The register in which the record is kept: one country, or for com, com-es and com-fr a group of countries (see country). |  | `be` | `markt` |
| `country` | string | ISO 3166-1 alpha-2 code in lower case (gb for the United Kingdom). Empty only for a few records that are not on an official list. |  | `be` | `land` |
| `institution` | string | Name of the institution, as on the official list or in full. |  | `Universiteit Gent` | `instelling` |
| `institution_type` | string | The category of the institution in the official list of its country, in the terms of that list (for example university, hogeschool, haute_ecole, universidad_publica). |  | `universiteit` | `type` |
| `on_official_list` | boolean | true if the institution is on the official list of recognised institutions of its country and counts in the denominator of the figures; false for the few records outside those lists. |  | `true` | (new) |
| `status` | string | Outcome of the research for this institution. | `checked`, `link_only`, `no_rule_found`, `not_found`, `not_researched` | `checked` | `status` |
| `rule_type` | string | Our label for the main rule of the source; not the institution's own term. Empty for not_found and not_researched. | `permitted`, `disclosure`, `consult_supervisor`, `prior_approval`, `left_to_programme`, `misconduct_only`, `link_only`, `none` | `permitted` | `soort` |
| `rule_summary` | string | Our one-sentence summary of the rule, in the language given by summary_language. Not a quotation: the literal quotation, where one was checked, is in the column quote. Empty for link_only, not_found and not_researched. |  | `Verantwoord gebruik van generatieve AI is toegelaten, ook in` | `regel` |
| `summary_language` | string | ISO 639-1 code of the language of rule_summary (the language of the register, or of the institution in Switzerland). |  | `nl` | (new) |
| `quote` | string | For checked records only: the passage of the source that carries the rule, word for word, in the original language (not translated), at most 300 characters. Empty for every other status, and where the quotation on file is longer. The column quote contains short quotations from the institutions' own published rules, included under the quotation exception (Art. 5(3)(d) Directive 2001/29/EC; Belgian Code of Economic Law, Art. XI.189). They are not licensed under CC BY 4.0; rights remain with the institutions. |  | `voor de masterproef is het verantwoord gebruik van generatie` | (new) |
| `applies_to` | string | Free text in the language of the register: the level or unit the source covers, or the number of unit regulations checked. |  | `hele instelling (algemene UGent-richtlijnen op het studenten` | `geldt_voor` |
| `scope` | string | Scope of the source, for checked and link_only. | `institution`, `unit` | `institution` | `bereik` |
| `counts_as_institution_rule` | boolean | true if the record counts as a rule of the whole institution in the figures: on_official_list is true, status is checked or link_only, and scope is institution. Count the records with true to reproduce institution_rule in coverage.csv and summary.csv and the figure on the register pages; false for every other record. |  | `true` | `telt_als_regel_instelling` |
| `source_title` | string | Title of the source document or page. |  | `Studentenportaal: Generatieve AI in het UGent-onderwijs` | `bron_titel` |
| `source_url` | string | URL of the source, on the institution's own site. |  | `https://www.ugent.be/student/nl/lessen-examens/lesmateriaal/` | `bron_url` |
| `checked_on` | date | Date of the last check (checked, no_rule_found), the date the link was seen (link_only), the date of the last search (not_found) or the date the institution was listed (not_researched). |  | `2026-11-19` | `gecontroleerd` |
| `source_changed_on` | date | Empty, or the date on which the regular check found that the quotation is no longer in the source. The record is then being re-checked; until it has been read again, treat the rule as possibly out of date. |  |  | `herzien_sinds` |
| `reason` | string | Why a link_only record could not be checked, or why a not_found record has no source. | `http_403`, `robots_txt`, `refused`, `no_text_layer`, `no_public_source`, `gate_refused`, `not_retrievable` | `no_public_source` | `reden` |
| `search_round` | string | For not_found: the search round in which the institution was last searched, where recorded (from release 2026.11.5). |  |  | (new) |
| `search_steps` | integer | For not_found: the number of logged search steps (pages fetched and queries run) without a qualifying source. Distinguishes 'searched, nothing found' from not_researched. |  | `20` | (new) |
| `record_page` | string | Page on the maintainer's site about this institution's rule, where one exists. |  | `https://www.esmond.be/ai-gebruiken-masterproef-ugent/` | `esmond_pagina` |

### status

| value | meaning | legacy value |
|---|---|---|
| `checked` | The source was fetched through a gate that follows robots.txt, and the quotation that supports our summary is in the fetched text word for word. | `getoetst` |
| `link_only` | The institution publishes the rule at an official URL of its own, but the text cannot be checked word for word (see reason). Link only: no summary. | `gepubliceerd_niet_getoetst` |
| `no_rule_found` | The current regulations of the whole institution (or of one level of it), dated 2024 or later, were read and the search terms for AI are not in the text. The summary names the document and its year. | `geen_regel_gevonden` |
| `not_found` | Researched, and no public source of the institution found that meets the conditions. search_steps gives the number of logged search steps. | `onvindbaar` |
| `not_researched` | On the official list, not yet researched. | `niet_onderzocht` |

### rule_type

| value | meaning | legacy value |
|---|---|---|
| `permitted` | The institution allows some uses of AI, with conditions. | `toegestaan` |
| `disclosure` | The student states which tools were used and what for, in a declaration or acknowledgement. | `melding` |
| `consult_supervisor` | The rule asks the student to talk to the supervisor before using a tool. | `overleg` |
| `prior_approval` | Use in the thesis needs approval in advance. | `goedkeuring` |
| `left_to_programme` | The institution leaves the decision to the programme, department or examiner. | `opleiding` |
| `misconduct_only` | The regulations mention AI only in the clause on misconduct or plagiarism and do not say which uses are permitted. | `fraude` |
| `link_only` | Status link_only: the kind of rule was not read. | `gepubliceerd` |
| `none` | Status no_rule_found. | `geen` |

### scope

| value | meaning | legacy value |
|---|---|---|
| `institution` | The source applies to the whole institution (including a graduate school, a regulation for one level of the whole institution, or the same provision in the regulations of every unit). | `instelling` |
| `unit` | The source is a document of one faculty, department, institute or programme. Not counted as a rule of the institution. | `onderdeel` |

### reason

| value | meaning | legacy value |
|---|---|---|
| `http_403` | link_only: the server answers 403. | `403` |
| `robots_txt` | link_only: robots.txt excludes automated access, so the gate refuses. | `robots` |
| `refused` | link_only: another refusal by the server, such as a different error status or a bot check. | `geweigerd` |
| `no_text_layer` | link_only: the document is a PDF without a usable text layer (a scan). | `geen_tekst` |
| `no_public_source` | not_found: nothing found. | `geen_publieke_bron` |
| `gate_refused` | not_found: the site refuses the gate and no URL is known that is itself the rule. | `poort_weigert` |
| `not_retrievable` | not_found: a source was named but could not be fetched. | `niet_op_te_halen` |

### register

One register per country, except: `com` (English-language register: United States, United Kingdom, Canada, Australia, New Zealand, Singapore, Malaysia, English-speaking Africa and others), `com-es` (Spanish-speaking Latin America), `com-fr` (French-speaking Africa), `be` (Flanders) and `wb` (Wallonia-Brussels), both Belgium. The column `country` gives the country of every record.

## units.csv (rules of one faculty, programme or the thesis under a record)

More specific than the rule of the record, each checked like a `checked` record. Not counted in any figure.

| column | type | definition | values | example | legacy name |
|---|---|---|---|---|---|
| `record_id` | string | The id of the institution record in alle.csv. |  | `be-ugent` | `record_id` |
| `unit` | string | Name of the faculty, programme or thesis regulation. |  | `Faculteit Letteren en Wijsbegeerte` | `onderdeel` |
| `level` | string | faculty, programme, or thesis (a rule for the thesis itself). | `faculty`, `programme`, `thesis` | `faculty` | `niveau` |
| `rule_type` | string | As in alle.csv. | `permitted`, `disclosure`, `consult_supervisor`, `prior_approval`, `left_to_programme`, `misconduct_only`, `link_only`, `none` | `disclosure` | `soort` |
| `rule_summary` | string | Our one-sentence summary, in the language of summary_language. |  | `De faculteit vraagt bij elke schrijftaak, bachelorproef en m` | `regel` |
| `summary_language` | string | ISO 639-1 code of the language of rule_summary. |  | `nl` | (new) |
| `source_title` | string | Title of the source. |  | `Verantwoord gebruik van generatieve AI, Faculteit Letteren e` | `bron_titel` |
| `source_url` | string | URL of the source. |  | `https://www.ugent.be/lw/nl/student/opleiding-studie/generati` | `bron_url` |
| `checked_on` | date | Date of the last check. |  | `2026-11-16` | `gecontroleerd` |
| `source_changed_on` | date | As in alle.csv. |  |  | `herzien_sinds` |

## coverage.csv and coverage.json (one row per register and country with an official list)

| column | type | definition | values | example | legacy name |
|---|---|---|---|---|---|
| `register` | string | The register. |  |  | `register` |
| `country` | string | ISO 3166-1 alpha-2, lower case. |  |  | `land` |
| `official_list` | string | The official list of recognised institutions used as the denominator (title, in the language of the list). |  |  | `lijst` |
| `official_list_url` | string | URL of the official list. |  |  | `lijst_url` |
| `official_list_date` | date | Date on which the list was read. |  |  | `lijst_datum` |
| `on_list` | integer | Number of institutions on the list (the denominator). |  |  | `op_de_lijst` |
| `researched` | integer | Institutions researched (on_list minus not_researched). |  |  | `onderzocht` |
| `checked` | integer | Records with status checked. |  |  | `getoetst` |
| `link_only` | integer | Records with status link_only. |  |  | `gepubliceerd_niet_getoetst` |
| `unit_only` | integer | Of checked plus link_only: records whose source is the rule of one unit only (scope = unit). |  |  | `alleen_onderdeel` |
| `no_rule_found` | integer | Records with status no_rule_found. |  |  | `geen_regel_gevonden` |
| `not_found` | integer | Records with status not_found. |  |  | `onvindbaar` |
| `not_researched` | integer | Records with status not_researched. |  |  | `niet_onderzocht` |
| `institution_rule` | integer | checked + link_only - unit_only: institutions that publish a rule for the whole institution (the records with counts_as_institution_rule = true). |  |  | `regel_instelling` |
| `disclosure` | integer | Of institution_rule: rule_type disclosure. |  |  | `vraagt_verklaring` |

## summary.csv and summary.json (one row per country, computed from alle.csv)

Only records with `on_official_list = true`. Anyone can recompute it from alle.csv: group by `country`, count `status`, and count `checked` plus `link_only` records by `scope` and `rule_type`. `institution_rule` is the number of records with `counts_as_institution_rule = true`.

| column | type | definition | values | example | legacy name |
|---|---|---|---|---|---|
| `country` | string | ISO 3166-1 alpha-2, lower case. |  |  | |
| `country_name` | string | English name of the country. |  |  | |
| `region` | string | Region, for grouping: Europe, North America, Latin America, Africa, Asia and Oceania. |  |  | |
| `registers` | string | The register(s) that cover the country, separated by a semicolon. |  |  | |
| `on_list` | integer | Institutions on the official list (the denominator). |  |  | |
| `researched` | integer | Institutions researched. |  |  | |
| `institution_rule` | integer | Institutions that publish a rule for the whole institution (checked or link_only, scope institution): the records with counts_as_institution_rule = true. |  |  | |
| `institution_rule_share` | number | institution_rule / on_list, three decimals. |  |  | |
| `unit_only` | integer | Institutions with a rule of one unit only (scope unit). |  |  | |
| `no_rule_found` | integer | Status no_rule_found. |  |  | |
| `not_found` | integer | Status not_found. |  |  | |
| `not_researched` | integer | Status not_researched. |  |  | |
| `rule_permitted` | integer | Of institution_rule: rule_type permitted. |  |  | |
| `rule_disclosure` | integer | Of institution_rule: rule_type disclosure. |  |  | |
| `rule_consult_supervisor` | integer | Of institution_rule: rule_type consult_supervisor. |  |  | |
| `rule_prior_approval` | integer | Of institution_rule: rule_type prior_approval. |  |  | |
| `rule_left_to_programme` | integer | Of institution_rule: rule_type left_to_programme. |  |  | |
| `rule_misconduct_only` | integer | Of institution_rule: rule_type misconduct_only. |  |  | |
| `rule_link_only` | integer | Of institution_rule: rule_type link_only. |  |  | |

## Legacy files

`legacy/` holds the same records with the Dutch column names and values of releases up to 2026.11.4, for one release. The column *legacy name* above and the tables of values give the mapping. `dekking.csv`, `dekking.json` and `changelog.json` stay in the main folder in their Dutch form for existing links; `coverage.*` and `CHANGELOG.md` are their English versions.
