Skip to main content
Version: 0.17.23

Use Data Docs URLs in custom Validation Actions

To create a custom Validation Action that includes a link to the Data DocsHuman readable documentation generated from Great Expectations metadata detailing Expectations, Validation Results, etc., you get the Data Docs URL for the Validation ResultsGenerated when data is Validated against an Expectation or Expectation Suite. page from your Validation Results after you run a CheckpointThe primary means for validating data in a production deployment of Great Expectations.. This method returns the URLs for any type of Data Docs site setup including S3 or a local setup.

The code used in this topic is available on GitHub here:



First, within the _run method of your custom Validation Action, instantiate an empty dict to hold your sites:

data_docs_validation_results: dict = {}


Next, call get_docs_sites_urls to get the urls for all the suites processed by this Checkpoint:

docs_site_urls_list = self.data_context.get_docs_sites_urls(
site_names=self._site_names, # type: ignore[arg-type] # could be a `str`


The above step returns a list of dictionaries containing the relevant information. Now, we need to iterate through the entries to build the object we want:

for sites in docs_site_urls_list:
data_docs_validation_results[sites["site_name"]] = sites["site_url"]


You can now include the urls contained within the data_docs_validation_results dictionary as links in your custom notifications, for example in an email, Slack, or OpsGenie notification, which will allow users to jump straight to the relevant Validation Results page.

🎉 You've just accessed Data Docs URLs for use in custom Validation Actions! 🎉