360Giving Data Standard » Extensions » Diversity, Equity, and Inclusion Extension » Technical Reference

Technical Reference

Extension Structure Overview

The DEI Extension defines new fields and structures for use within 360Giving data, for the purpose of publishing data using the DEI Data Standard within a file of 360Giving grant data. It also adds a number of new codelists to validate the contents of various fields.

Some fields are used to share taxonomy and free text data collected by publishers who have implemented the DEI Data Standard. There are also fields used to share metadata, which allow publishers to provide information about how the DEI Data Standard was applied in their specific context.

The DEI Extension adds a new field called deiDetails to each grant. Inside deiDetails there are three fields: leadership, mission, and project. These represent the three application areas of the DEI Data Standard for grantmaking.

Each of the leadership, mission, and project fields has the format of a DeiApplicationArea object. This is a new object defined by the DEI Extension so that each application area and its responses have the same structure and semantics, which makes the data more consistent and simpler to publish and use. DeiApplicationArea contains fields for important metadata to represent whether a question was asked (and how), as well as for sharing the responses to these questions.

The extension structure (using JSON schema names) is as follows:

grants (from 360Giving Data Standard)
- deiDetails
  - deiVersion
  - purposes
  - leadership, mission, and project (DeiApplicationArea)
    - askedStatus (required)
    - replyStatus
    - availableOptions
    - additionalDetails
    - response
      - taxonomyCodes
      - livedExperience
      - Geography

In the extension, the deiDetails field is optional for each grant. However, when it is included then leadership, mission, and project become required for that grant, and each of these then have a required askedStatus field.

For a publisher of data using this extension this means that:

If there is no DEI information for the grant, you may omit the entire deiDetails field for that grant
If there is DEI information for the grant, then you must include the deiDetails field and provide at least a value in askedStatus for each of the leadership, mission and project application areas. This is to ensure a minimum level of context required for a user to interpret the data correctly.

Schema

This section contains a reference for the Extension’s schema

Title	Description	Type	Required
DEI Details:DEI Data Standard Version	The version of the DEI Data Standard that this data uses e.g. 1.1	string	False
DEI Details:Purposes	The purposes of collecting this data.	string	False
DEI Details:Leadership:Asked Status	A code referring to how this question was asked. The value for this field should be drawn from the Asked Status codelist.	string	True
DEI Details:Leadership:Reply Status	A code referring to the status of the reply to this question. The value for this field should be drawn from the Reply Status codelist.	string	False
DEI Details:Leadership:Available Options	Code(s) referring to options which were available when the question was asked. The value for these codes should be drawn from the Available Options codelist.	array[string]	False
DEI Details:Leadership:Additional Details	A free text field to include any additional details or rationales that may be important to this context.	string	False
DEI Details:Leadership:DEI Response:Taxonomy Codes	The Taxonomy Codes selected from the DEI Taxonomies. The value for these codes should be drawn from the Taxonomy Codes codelist.	array[string]	False
DEI Details:Leadership:DEI Response:Lived Experience	A free text description of other types of lived experience that is not drawn from the Taxonomy.	string	False
DEI Details:Leadership:DEI Response:Geography	A free text description that is not drawn from a vocabulary but instead relates to a particular geographical area.	string	False
DEI Details:Mission:Asked Status	A code referring to how this question was asked. The value for this field should be drawn from the Asked Status codelist.	string	True
DEI Details:Mission:Reply Status	A code referring to the status of the reply to this question. The value for this field should be drawn from the Reply Status codelist.	string	False
DEI Details:Mission:Available Options	Code(s) referring to options which were available when the question was asked. The value for these codes should be drawn from the Available Options codelist.	array[string]	False
DEI Details:Mission:Additional Details	A free text field to include any additional details or rationales that may be important to this context.	string	False
DEI Details:Mission:DEI Response:Taxonomy Codes	The Taxonomy Codes selected from the DEI Taxonomies. The value for these codes should be drawn from the Taxonomy Codes codelist.	array[string]	False
DEI Details:Mission:DEI Response:Lived Experience	A free text description of other types of lived experience that is not drawn from the Taxonomy.	string	False
DEI Details:Mission:DEI Response:Geography	A free text description that is not drawn from a vocabulary but instead relates to a particular geographical area.	string	False
DEI Details:Project:Asked Status	A code referring to how this question was asked. The value for this field should be drawn from the Asked Status codelist.	string	True
DEI Details:Project:Reply Status	A code referring to the status of the reply to this question. The value for this field should be drawn from the Reply Status codelist.	string	False
DEI Details:Project:Available Options	Code(s) referring to options which were available when the question was asked. The value for these codes should be drawn from the Available Options codelist.	array[string]	False
DEI Details:Project:Additional Details	A free text field to include any additional details or rationales that may be important to this context.	string	False
DEI Details:Project:DEI Response:Taxonomy Codes	The Taxonomy Codes selected from the DEI Taxonomies. The value for these codes should be drawn from the Taxonomy Codes codelist.	array[string]	False
DEI Details:Project:DEI Response:Lived Experience	A free text description of other types of lived experience that is not drawn from the Taxonomy.	string	False
DEI Details:Project:DEI Response:Geography	A free text description that is not drawn from a vocabulary but instead relates to a particular geographical area.	string	False

Codelists

The extension adds several codelists to promote interoperability between datasets. These are all closed codelists, meaning that only values from the codelists may be used.

Asked Status

A codelist to declare whether DEI Data Standard questions were asked for this grant, and how.

Code	Title	Description
AS100	Not Asked Not Applicable	Not asked because this was not applicable to this situation
AS101	Not Asked Historical Data	Not asked because this grant was made before any DEI process was adopted
AS200	Asked During The Application Process	This was asked before a decision was made to award the grant
AS201	Asked After The Application Process	This was asked after a decision was made to award the grant

Available Options

A codelist to declare which answer options were available to the respondents.

Code	Title	Description
AO100	Taxonomy Population Group	The respondant may select the DEI Taxonomy codes referring to Population Group
AO101	Taxonomy Category	The respondant may select the DEI Taxonomy codes referring to Categories within a Population Group
AO102	Taxonomy Subcategory	The respondant may select the DEI Taxonomy codes referring to Subcategories within a Category
AO200	Geography	The respondant may enter a description of the relevant geography in a field
AO201	Lived Experience	The respondant may enter a description of the relevant lived experience in a field
AO300	General	The respondant may declare that this is general and therefore not aimed at or consisting of a specific group of people
AO301	Prefer Not To Say	The respondant may select an option that they prefer not to say

Reply Status

A codelist to declare whether a reply to DEI Data Standard questions was received or not.

Code	Title	Description
RS100	No Reply	No reply was received
RS200	Reply Got	A reply was received
RS201	Reply was General	The reply is general and is not aimed at or does not consist of a specific group of people
RS202	Reply was Prefer not to say	The reply was Prefer not to say
RS203	Reply Got but no permissions	A reply was received but is not permitted to be shared as open data

Taxonomy Codes

The authoritative source for the DEI Taxonomy codes vocabulary is the DEI Data Standard and should take precedence over all other sources of information about the DEI Taxonomy codes, including this codelist.

The DEI Extension for 360Giving creates and maintains this codelist by taking the hierarchical codes defined in the DEI Data Standard, encoding them into JSON, and then generating this codelist automatically. This is necessary to provide a machine-readable codelist to support validation.

Please see the Governance and Versioning section for more information on how we respond to updates in the DEI Standard.

Code	Title	Description
DEI010000	Communities experiencing racial inequity	Organisations working on racial justice or supporting people from multiple communities
DEI010100	Black / African / Caribbean / Black British	Mixed Black/ Black British
DEI010110	African
DEI010120	Caribbean
DEI010199	Any other Black/ African/ Caribbean background
DEI010200	Mixed	Mixed groups
DEI010210	White and Black
DEI010220	White and Asian
DEI010299	Any other Mixed / Multiple ethnic background
DEI010300	Asian / Asian British	Mixed Asian/ Asian British
DEI010310	Indian
DEI010320	Pakistani
DEI010330	Bangladeshi
DEI010340	Chinese
DEI010399	Any other Asian background
DEI019900	Other Group experiencing ethnic or racial inequity
DEI019910	Arab
DEI019920	Jewish
DEI019930	Gypsy, Roma and Traveller Communities
DEI019999	Any other Ethnic group
DEI020000	Disabled people	Working with people across multiple disabilities
DEI020100	Physical Impairment	Working with people with multiple or different physical impairments
DEI020110	Mobility	Physical/mobility impairment, such as a difficulty using your arms or mobility issues which require you to use a wheelchair or crutches
DEI020120	Visual impairment/ partial sight/sight loss	Visual impairment, such as being blind or having a serious visual impairment
DEI020130	Hard of hearing/ deaf/ hearing loss	Hearing impairment, such as being deaf or having a serious hearing impairment
DEI020140	Speech impairment	Impaired ability to produce speech sounds
DEI020200	Mental Health	Mental health condition or experience, such as depression or psychosis or addiction that impacts people’s lives
DEI020300	Cognitive differences	Multiple or different cognitive differences
DEI020310	Learning disability	A reduced intellectual ability and difficulty with everyday activities which affects someone for their whole life, such as Down’s Syndrome
DEI020320	Learning difficulty	Learning difficulties such as dyslexia and ADHD
DEI020330	Neurodivergent	Cognitive difference such as autistic spectrum disorder where individuals are impacted by the social environment
DEI020400	Health	Long-standing illness or health condition, such as cancer, HIV, diabetes, chronic heart disease or epilepsy, or other rare conditions
DEI029900	Other	Other - An impairment, medical condition or environmental disadvantage that is not listed above
DEI030000	Faith	Interfaith and multi-faith groups
DEI030100	Catholic	People who describe their faith as Catholic or Roman Catholic
DEI030200	Protestant	Anglicans, Adventists, Baptists, Methodists, Pentecostals, Presbyterians, Religious Society of Friends, Reformed Churches and other Protestant denominations
DEI030300	Other Christian denominations	Orthodox and other denominations
DEI030400	Buddhist
DEI030500	Hindu
DEI030600	Jewish
DEI030700	Muslim
DEI030800	Sikh
DEI030900	Atheist
DEI031000	Agnostic
DEI039900	Other	Other faiths and beliefs
DEI040000	LGBT+ People	Working with LGBT+ people with multiple identities
DEI040100	Bisexual people	All bisexual people
DEI040110	Bisexual men
DEI040120	Bisexual women
DEI040200	Gay men
DEI040300	Lesbian/gay women
DEI040400	Transgender people	All transgender people
DEI040410	Trans men
DEI040420	Trans women
DEI040500	Non-binary people
DEI049900	Other	Other LGBT+ People, including queer and intersex people
DEI050000	Migrants	Migrants with multiple status
DEI050100	Asylum seekers
DEI050200	Refugees
DEI050300	Undocumented People
DEI059900	Other Migrants	This includes other migrants with official immigration status, e.g. international students; and who are naturalised British
DEI060000	Older People	Typically those aged 60 and over
DEI070000	Children and Young People	Typically people under 26 but sometimes people under 19
DEI070100	Young adults	Typically young people from 16 to 25 years of age
DEI070200	Young people	Typically young people from 8 to 25
DEI070300	Children	Under 16
DEI070400	Infants	Under 2 years of age
DEI080000	People who are educationally or economically disadvantaged	This will be defined by the organisation, such as children eligible for free school meals or for adults were eligible for free school meals as a child, families receiving benefits or universal credit, people who are homeless, people who did not complete formal education or otherwise considered in deprivation or poverty etc.
DEI090000	Women and girls	Those who identify and live as women and girls
DEI700000	Welsh Language Speaking
DEI800010	The Protestant community
DEI800020	The Catholic community
DEI800030	Neither

Getting further help

This guidance aims to support funders through the 360Giving publishing process. If you can't find the information you need or you have further questions email 360Giving Helpdesk. You can help us improve this guidance by filling out our feedback form.