hasura/graphql-engine · error · CompatibilityError

compatibility date {0} is in the future

Error message

compatibility date {0} is in the future

What it means

The specified compatibility date is in the future relative to the engine's current date; no config can exist for dates beyond the shipped entries.

Source

Thrown at v3/crates/compatibility/src/config.rs:36

/// The compatibility configuration of the Hasura metadata.
pub struct CompatibilityConfigV2 {
    /// Any backwards incompatible changes made to Hasura DDN after this date won't impact the metadata.
    pub date: CompatibilityDate,
    // TODO: add flags.
}

#[derive(Debug, PartialEq, thiserror::Error)]
pub enum CompatibilityError {
    #[error("no compatibility config found")]
    NoCompatibilityConfigFound,
    #[error("duplicate compatibility config found")]
    DuplicateCompatibilityConfig,
    #[error("compatibility date {specified} is too old, oldest supported date is {oldest}")]
    DateTooOld {
        specified: CompatibilityDate,
        oldest: CompatibilityDate,
    },
    #[error("compatibility date {0} is in the future")]
    DateInTheFuture(CompatibilityDate),
}

View on GitHub (pinned to 724551b9ae)

Solutions

1. Correct the date if it's a typo (compare {0} with today)
2. Check the machine clock if the date looks reasonable
3. Upgrade the engine if the project legitimately targets a newer release

Example fix

// before
compatibility_date = "3023-01-01"
// after
compatibility_date = "2025-01-01"

if (specifiedDate > today()) throw new Error('compatibility date in the future');

When it happens

Trigger: A project compatibility date later than today / later than the newest bundled compatibility entry.

Common situations: Typos like 2033 instead of 2023; system clock set incorrectly on the build machine; project created with a newer engine and run against an older one.

Related errors

• compatibility date {specified} is too old, oldest supported
• no compatibility config found
• duplicate compatibility config found
• cannot create migrations directory: %w
• cannot create seeds directory: %w

AI-assisted analysis of hasura/graphql-engine@724551b9ae (2026-08-28). Data as JSON: /api/errors/504818e7b564364f. Report an issue: GitHub.