There are two main options for enabling IndexNow for Astro sites on Cloudflare:Cloudflare Crawler Hints (zero-code, automated) respond in singing astro-indexnow integration (auto-commit on build)The
Here are the complete configuration steps.
Option 1: Cloudflare Crawler Hints (recommended, zero code)
Cloudflare has built-in IndexNow support, which automatically pushes updates to Bing, Yandex, etc. without modifying Astro code.
1. Premise
- The domain is connected to Cloudflare and resolving properly
- Astro site deployed to Cloudflare Pages/Workers
2. Open Crawler Hints
- Login to Cloudflare Dashboard → Go to your domain name
- Left Menu:Caching → Configuration
- locate Crawler Hints → Open Enable Crawler Hints
- Save Settings
Cloudflare automatically monitors site content changes and notifies search engines via the IndexNow protocol.
Option 2: astro-indexnow integration (commit at build time for precision and control)
Use the official astro-indexnow integration to automatically commit change URLs at Astro build time, for scenarios where you need to precisely control the timing of the commit.
1. Installation integration
# npm
npm install astro-indexnow --save-dev
# or with Astro CLI
npx astro add astro-indexnow
2. Generate and host the IndexNow API Key
- Generate Key: Visit the IndexNow website to generate an API Key (e.g., 19ea3a37344a414fb6c09554549114a9).
- Create a Key file: Create a new text file named [yourKey].txt in the Astro project public/ directory, the content is only the Key itself.
- Ensure accessibility: https://你的域名/[Key].txt opens properly after deployment
3. Configuring Astro
Edit astro.config.mjs to add the astro-indexnow integration and configure the site with Key:
import { defineConfig } from 'astro/config' ;
import indexnow from 'astro-indexnow' ;
export default defineConfig({
// You must configure your site's domain name
site: 'https://your-domain.com',
integrations: [
indexnow({
// Your IndexNow API Key
key: '19ea3a37344a414fb6c09554549114a9',
// Path to Key file (default root directory, corresponding to public)
keyLocation: '/19ea3a37344a414fb6c09554549114a9.txt',
// Optional: submission engine (default Bing, Yandex)
engines: ['bing', 'yandex'],
}),
],
});
4. Deployment to Cloudflare
- Cloudflare Pages: Connect to the Git repository and build the setup:
- Build command: npm run build
- Output directory: dist
- Cloudflare Workers: Install @astrojs/cloudflare adapter, configure output: ‘server’, deploy with wrangler deploy
5. Validation of submissions
- Build log: view astro build output to confirm a successful commit
- Bing Webmaster Tools: Access IndexNow panel to view the submission history
III. Comparison of the two programs
| programmatic | vantage | drawbacks | Applicable Scenarios |
|---|---|---|---|
| Cloudflare Crawler Hints | Zero code, automatic, free, no maintenance | Uncontrolled timing of commits, reliance on Cloudflare monitoring | Fast enablement and minimalism |
| astro-indexnow | Build-time precision commits, change-only commits, configurable engine | Integration, Configuration Key, Maintenance Files Required | Need for precise control, multi-site management |











