AEO for Drupal
Work out which behavior comes from Drupal core, and which comes from contributed modules or your theme. Set up JSON-LD for the content types you use. Then inspect representative published nodes.
Default robots.txt behavior
Drupal 11 ships robots.txt rules that exclude administration, search, account and internal paths. Deployment files can change those rules. If you use the contributed RobotsTxt module, its generated output has no effect while the site serves a physical robots.txt from the web root instead. Composer Scaffold can also overwrite scaffold files. You must configure it to preserve your changes.
Decide whether to permit search and user-fetch crawlers separately from training crawlers, within the controls your platform provides. See how AEOprobe distinguishes crawler roles.
Default structured data
Published JSON-LD depends on the theme, custom code and installed modules. Metatag is a contributed module, not Drupal core. Schema.org Metatag extends it with JSON-LD and token-based settings. These settings can be global, set per content type or overridden for a single node.
Common AEO issues
| Issue | Impact | Fix |
|---|---|---|
| A physical robots.txt masks module settings | ImpactThe served crawler rules differ from the configuration you edited. | FixInspect the public /robots.txt response. Ask the deployment owner to resolve the conflict between the physical file and the module’s routing. |
| Schema tokens map to missing or incorrect fields | ImpactPublished nodes contain empty values or facts that do not match the content. | FixConfigure content-type defaults in /admin/config/search/metatag. Then inspect a published node with those fields filled in. |
Plugins and modules
- Metatag(opens in a new tab)
A contributed metadata module. Schema.org Metatag builds on it. Check that the release works with your Drupal version.
- Schema.org Metatag(opens in a new tab)
A contributed extension that adds JSON-LD with token mappings and content-type defaults.
Step-by-step guide
- 1
Inspect rules served by the deployment
Open the public /robots.txt. Compare it with the file or module configuration your deployment uses. If Composer Scaffold manages that file, use its supported customization. A manual edit can be overwritten by updates.
- 2
Enable only the markup modules you need
Inspect the existing JSON-LD first. If you use Metatag and Schema.org Metatag to fill a gap, install compatible contributed releases. Enable only the relevant Schema.org submodules, not every available schema type.
- 3
Map a real content type and inspect it
Open /admin/config/search/metatag. Configure the relevant defaults and token mappings. Check one published node of each configured type. Then edit a source field and check that the published JSON-LD shows the change.
Official documentation
- Drupal 11 robots.txt(opens in a new tab)
Version-specific core crawler rules.
- Schema.org Metatag usage(opens in a new tab)
Defaults, token mappings and configuration workflow.
- Metatag configuration(opens in a new tab)
The /admin/config/search/metatag route.
- RobotsTxt module(opens in a new tab)
Generated per-site rules and the physical-file constraint.
- Drupal Composer Scaffold(opens in a new tab)
Supported customization of deployment-managed files.
Questions
Are Metatag and Schema.org Metatag part of core?
No. They are contributed modules. Your theme or custom code may already publish markup. Check that output before you add them.
Will a manual robots.txt edit survive updates?
Not necessarily. Composer Scaffold manages files and overwrites them by default. Use its documented customization. Then check that the public response matches the file you intend or the RobotsTxt module output.
The free audit checks up to 3 public pages with no sign-up. Structured data checks read JSON-LD only. Microdata and RDFa are not parsed. Findings do not guarantee rankings or AI citations.
A saved-site audit costs 20 credits. It covers up to 10 pages on Free, 50 on Watch and 100 on Pro. AEOprobe plans are Free at €0/month, Watch at €7/month and Pro at €21/month. Your account shows what you can buy.
Run the free audit on your site