{"record":{"id":"d324015644a87f11","repo":"gatsbyjs/gatsby","slug":"pretty-permalinks-are-not-enabled-in-your-wordpres","errorCode":null,"errorMessage":"Pretty permalinks are not enabled in your WordPress instance.\nGatsby routing requires this setting to function properly.\nPlease enable pretty permalinks by changing your settings at\n${data.generalSettings.url}/wp-admin/options-permalink.php.\n","messagePattern":"Pretty permalinks are not enabled in your WordPress instance\\.\nGatsby routing requires this setting to function properly\\.\nPlease enable pretty permalinks by changing your settings at\n(.+?)/wp-admin/options-permalink\\.php\\.\n","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby-source-wordpress/src/steps/check-plugin-requirements.ts","lineNumber":271,"sourceCode":"  try {\n    const { data } = await fetchGraphql({\n      query: /* GraphQL */ `\n        {\n          generalSettings {\n            url\n          }\n          wpGatsby {\n            arePrettyPermalinksEnabled\n          }\n        }\n      `,\n      throwGqlErrors: true,\n      isFirstRequest: true,\n    })\n\n    if (!data.wpGatsby.arePrettyPermalinksEnabled) {\n      helpers.reporter.log(``)\n      helpers.reporter.warn(\n        formatLogMessage(`\nPretty permalinks are not enabled in your WordPress instance.\nGatsby routing requires this setting to function properly.\nPlease enable pretty permalinks by changing your settings at\n${data.generalSettings.url}/wp-admin/options-permalink.php.\n`)\n      )\n    }\n  } catch (e) {\n    // the WPGatsby version is too old to query for wpGatsby.arePrettyPermalinksEnabled\n  }\n}\n\nconst ensurePluginRequirementsAreMet = async (\n  helpers: NodePluginArgs\n): Promise<void> => {\n  if (\n    helpers.traceId === `refresh-createSchemaCustomization` ||","sourceCodeStart":253,"sourceCodeEnd":289,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby-source-wordpress/src/steps/check-plugin-requirements.ts#L253-L289","documentation":"prettyPermalinksAreEnabled queries wpGatsby.arePrettyPermalinksEnabled and the site's URL; the warning fires when WordPress still uses plain (non-pretty) permalinks (e.g. /?p=123). Gatsby's page routing and node relationships rely on clean paths, so requirements checking flags it; the build continues but routing/preview behavior may be broken until permalinks are switched to a pretty structure.","triggerScenarios":"Thrown at packages/gatsby-source-wordpress/src/steps/check-plugin-requirements.ts:271 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["In WordPress admin go to Settings > Permalinks and select any option other than Plain.","Save changes to flush the rewrite rules, then re-run the Gatsby build.","Confirm the WPgatsby plugin is active so arePrettyPermalinksEnabled is reported correctly."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"e85d62f1779e353eaac1753211629a26d123e26c","analyzedAt":"2026-08-26T17:50:09.662Z","contentChangedAt":"2026-08-26T17:50:09.662Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}