Skip to content
IndexNow
IndexNow
URL queue and search-engine notifications via the IndexNow protocol
  • MODX 2
  • MODX 3
  • PHP 7.2
  1. Extras
  2. IndexNow
  3. System settings

System settings ​

IndexNow area under System → System settings. Keys use underscores: indexnow_*. The IndexNow manager has no settings editor.

KeyTypeDefaultDescription
indexnow_enabledYes/NoYesMaster switch. When No, resources are not enqueued.
indexnow_endpointtexthttps://yandex.com/indexnowIndexNow API URL. Only http / https. Default is Yandex; see their docs.
indexnow_queue_enabledYes/NoYesQueue mode.
indexnow_batch_sizenumber100How many due URLs the worker claims per pass, then groups by host. Range 1–1000. Queue tick caps this at 25 URLs.
indexnow_max_attemptsnumber3Attempts on temporary errors, then status failed.
indexnow_retry_delaynumber300Seconds before the next attempt.
indexnow_history_retention_daysnumber30Days to keep history. Old rows are purged during worker runs.
indexnow_keytextgeneratedIndexNow key (8–128 chars: letters, digits, -). Do not paste it into public tickets or logs.

The package reads optional keys indexnow_core_path and indexnow_assets_url via getOption with default paths. A clean install does not create them. They appear only when migrating old dotted keys (indexnow.core_path, indexnow.assets_url).

Common tweaks ​

  • Another IndexNow-compatible endpoint → indexnow_endpoint.
  • Pause notifications → indexnow_enabled = No.
  • Large site, many edits → indexnow_batch_size (max 1000).
  • Frequent 429 → increase indexnow_retry_delay.

Queue enabled vs disabled ​

Keep indexnow_queue_enabled = Yes in production. Scheduler and Process queue pick up due URLs when tick did not run.

indexnow_queue_enabled = Yesindexnow_queue_enabled = No
After enqueuekickQueue() → queue tick on shutdownImmediate worker->run() in the same request
Per-pass limitUp to 25 URLs (tick); up to indexnow_batch_size (Process queue, Scheduler)Full indexnow_batch_size
Client responseDoes not wait for the endpointWaits for delivery to the endpoint