Skip to main content
This is documentation for an older release that is still maintained. Latest version
Version: 4

Ed-Fi Data Standards

Documentation Home​

The Ed-Fi Unifying Data Model (UDM) is the widely adopted, CEDS-aligned, open-source data standard developed by the Ed-Fi community for the improvement of the community, and for the broader purpose of helping the K–12 education community in using data as a strategic asset to improve educational outcomes of students. The UDM captures the meaning and inherent structure of the most important information in the K–12 education enterprise.

The Ed-Fi UDM, along with the normative and non-normative guidance in the Ed-Fi Standards, serve as the foundation for enabling interoperability among secure data systems.

Data Model Documentation​

The data model is referred to as the Ed-Fi Unifying Data Model, or UDM. The UDM is documented via 2 primary artifacts: the Ed-Fi Data Handbook and a set of Unified Modeling Language (UML) diagrams.

Additional documentation is provided in the Ed-Fi Unifying Data Model documentation. This additional documentation provides narrative overviews of domains and key entities, as well as normative best practice guidance.

Version​

The most recent version and name for the Ed-Fi Data Standard is Ed-Fi Data Standard for Suite 3 v4.0.0.

This is the stable final version of Data Standard v4 following an early access release of the same version.

REST API Bindings​

This release contains introduces some changes classified as "breaking", so API clients using previous versions should be aware of and prepare for that change. API bindings will be published with the v4.0 final release.

Bulk / XML Bindings​

In addition, a set of Bulk / XML standards (core entity XML definitions and interchange specifications) based on this release are available on GitHub.

Sample Data​

The Data Standard includes sample data in the bulk XML format. The sample data is based on an entirely fictitious district called "Grand Bend ISD." Note that the sample data does not cover all model elements, and that while some effort is made to provide realistic data, the data is managed more to provide coverage of elements rather than realism.

Default Descriptors​

The Standard includes default "code sets" or "enumeration values" and their definitions. Descriptor values are published on GitHub in XML format.

Only descriptor values in the "ed-fi.org" namespace are part of the standard. In some contexts, the Alliance publishes values in the Grand Bend "gbisd.edu" namespace (Grand Bend the fictitious district for the sample data). This is done for descriptors whose actual values are nearly always locally defined, and therefore non-standardizable.

Data Exchange Standards​

For a list of standards built on the Ed-Fi Unifying Data Model, visit the Ed-Fi Data Exchange Standards Home.

Guidelines​

The Ed-Fi Alliance publishes technical guidelines for building solutions based on the Ed-Fi Data Standard: