[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"howto:gql:linux:en":3},{"resolvedFromAlias":4,"canonicalExt":5,"ext":5,"name":6,"category":7,"categoryName":8,"updatedAt":9,"os":10,"osLabel":11,"quickSolution":12,"stepByStep":13,"recommendedSoftware":16,"alternativeMethods":17,"commonIssues":18,"securityNote":37,"extensionPath":38,"extensionLabel":39,"breadcrumbs":40,"metaDescription":50},false,"gql","GraphQL Document (operations and fragments)","code","Code","2026-06-12T09:10:36.454Z","linux","Linux","To open .GQL files on Linux, open the .gql file in a text editor (e.g., your desktop’s default text editor or a code editor).",[14,15],"Open the .gql file in a text editor (e.g., your desktop’s default text editor or a code editor).","If you use LSP-based tooling, configure/enable the GraphQL language service so .gql is treated as a GraphQL document.",[],[],[19,25,31],{"title":20,"description":21,"steps":22},"The file opens as plain text with no GraphQL highlighting or validation","Many editors treat .gql as generic text unless GraphQL language tooling is installed or configured to include .gql as a recognized extension.",[23,24],"Install/enable GraphQL language tooling in your editor (GraphQL language service / plugin).","Check the tool’s settings for recognized file extensions and confirm .gql is included.",{"title":26,"description":27,"steps":28},"Build or code generation tools ignore .gql files","Some toolchains are configured to scan only certain extensions (often .graphql) for GraphQL documents.",[29,30],"Check your tool’s configuration for included document globs/extensions and add *.gql if needed.","If the tool cannot be configured, rename the file to an extension it scans (commonly .graphql) while keeping the content unchanged.",{"title":32,"description":33,"steps":34},"Requests fail at runtime because the .gql document is not valid for the server schema","A .gql file can be syntactically valid GraphQL but still fail against a specific schema (missing fields, wrong arguments, or fragment type mismatches).",[35,36],"Validate the document using schema-aware tooling (GraphQL language service / IDE integration) against the correct schema.","Update the operation/fragments to match the server schema and retry.",".gql files are plain text GraphQL documents, not executables; however, they can still drive sensitive data access when used as operations against a GraphQL endpoint (e.g., accidentally committing private queries or internal fragments).","/file-extension/gql",".GQL",[41,44,47],{"label":42,"to":43},"Home","/",{"label":45,"to":46},"How To","/file-extension",{"label":48,"to":49},"Open .GQL on Linux","/how-to/open-gql-on-linux","Learn how to open .GQL files on Linux with step-by-step instructions, recommended software, and troubleshooting tips."]