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.