{"record":{"id":"86f48c7c0953e641","repo":"hasura/graphql-engine","slug":"type-mapping-not-found-for-the-type-name-type-nam","errorCode":null,"errorMessage":"Type mapping not found for the type name {type_name:}","messagePattern":"Type mapping not found for the type name (.+?)","errorType":"error_code","errorClass":"InternalDeveloperError","httpStatus":null,"severity":"error","filePath":"v3/crates/plan/src/error.rs","lineNumber":69,"sourceCode":"        found: String,\n    },\n\n    #[error(\n        \"Typecasting session variable {session_variable} to an array is not supported. Update your compatibility date to enable JSON session variables\"\n    )]\n    VariableArrayTypeCastNotSupported {\n        session_variable: SessionVariableName,\n    },\n\n    #[error(\n        \"Expected session variable {session_variable} to be a valid JSON value, but encountered a JSON parsing error: {parse_error}\"\n    )]\n    VariableExpectedJson {\n        session_variable: SessionVariableName,\n        parse_error: serde_json::Error,\n    },\n\n    #[error(\"Type mapping not found for the type name {type_name:}\")]\n    TypeMappingNotFound {\n        type_name: Qualified<CustomTypeName>,\n    },\n\n    #[error(\"Field mapping not found for the field {field_name:} of type {type_name:}\")]\n    FieldMappingNotFound {\n        type_name: Qualified<CustomTypeName>,\n        field_name: FieldName,\n    },\n\n    #[error(\"{0}\")]\n    RelationshipFieldMappingError(#[from] crate::query::RelationshipFieldMappingError),\n\n    #[error(\"{0}\")]\n    MapFieldNamesError(#[from] MapFieldNamesError),\n\n    #[error(\n        \"The relationship '{relationship_name}' is from a nested object and cannot be used in a predicate\"","sourceCodeStart":51,"sourceCodeEnd":87,"githubUrl":"https://github.com/hasura/graphql-engine/blob/724551b9ae87845594ef0408cff0e50eb6c90dc5/v3/crates/plan/src/error.rs#L51-L87","documentation":"The plan crate (e.g. applying argument presets in query/arguments.rs or collecting relationship field mappings) could not find the type mapping for a Qualified<CustomTypeName> in the subgraph's type mappings. The metadata's type name has no corresponding mapping entry, so planning cannot proceed.","triggerScenarios":"Executing apply_input_field_presets_to_value or relationship field mapping collection where the type referenced by an argument preset or relationship field has no entry in the resolved type mappings — typically because the type was removed/renamed in the connector metadata after the plan/metadata was built, or the type is defined in a different subgraph.","commonSituations":"Deploying metadata and plan artifacts from different builds; renaming a model/object type in the connector without updating dependent presets or relationships; types sourced from another subgraph used where a local mapping is required.","solutions":["Regenerate/rebuild metadata and plan from the same source so type names and mappings stay in sync","Check the type name in the message and ensure it exists in this subgraph's resolved type mappings","If the type is remote, use the relationship/remote join path that expects remote types instead of a local mapping"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"// Before planning, verify each referenced type has a mapping\nfor name in metadata.referenced_type_names() {\n    if !subgraph.type_mappings.contains_key(&name) {\n        return Err(format!(\"no type mapping for {name}\"));\n    }\n}","typeGuard":null,"tryCatchPattern":"match err {\n    InternalDeveloperError::TypeMappingNotFound { type_name } => {\n        // rebuild metadata+plan together; check the type exists in this subgraph\n    }\n    _ => {}\n}","preventionTips":["Build and deploy metadata and plan artifacts from the same commit","Rename types atomically, updating presets and relationships in the same change"],"tags":["metadata","type-mapping","plan","hasura"],"backgroundTag":"missing-type-mapping","analyzedSha":"724551b9ae87845594ef0408cff0e50eb6c90dc5","analyzedAt":"2026-08-28T07:32:55.105Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}