Skip to main content
Version: 0.15.50

Custom Expectation

SetupArrowConnect to DataArrowCreate ExpectationsArrowValidate Data



A Custom Expectation is an extension of the Expectation class, developed outside the Great Expectations library.

Features and promises

Custom Expectations are intended to allow you to create ExpectationsA verifiable assertion about data. tailored to your specific data needs.

Relationship to other objects

Other than the development of Custom Expectations, which takes place outside the usual Great Expectations workflow for ValidatingThe act of applying an Expectation Suite to a Batch. data, Custom Expectations should interact with Great Expectations in the same way as any other Expectation would.

Use cases

SetupArrowConnect to DataArrowCreate ExpectationsArrowValidate Data

For details on when and how you would use a Custom Expectation to Validate Data, please see the corresponding documentation on Expectations.


Whatever you need

Custom Expectations are created outside Great Expectations. When you create a Custom Expectation, you can tailor it to whatever needs you and your data have.

API basics

How to access

If you are using a Custom Expectation to validate data, you will typically access it exactly as you would any other Expectation. However, if your Custom Expectation has not yet been contributed or merged into the Great Expectations codebase, you may want to set your Custom Expectation up to be accessed as a Plugin. This will allow you to continue using your Custom Expectation while you wait for it to be accepted and merged.

If you are still working on developing your Custom Expectation, you will access it by opening the python file that contains it in your preferred editing environment.

How to create

We provide extensive documentation on how to create Custom Expectations. If you are interested in doing so, we advise you reference our guides on how to create Custom Expectations.

How to contribute

Community contributions are a great way to help Great Expectations grow! If you've created a Custom Expectation that you would like to share with others, we have a guide on how to contribute a new Expectation to Great Expectations, just waiting for you!