Overview
The project uses @astrojs/sitemap to automatically generate XML sitemaps for search engine optimization. The sitemap includes all public pages with filtering options.
Installation
Install the sitemap integration:
npm install @astrojs/sitemap
Configuration
Enable sitemap in astro.config.mjs:
import sitemap from '@astrojs/sitemap';
export default defineConfig({
site: 'https://arteywebcreaciones.com',
integrations: [
sitemap({
filter: (page) => !page.includes('/recibido-ok') && !page.includes('/presupuesto'),
}),
// ... other integrations
],
});
Key Configuration
Site URL
site: 'https://arteywebcreaciones.com'
The site property is required for sitemap generation. Without it, URLs will be relative.
Page Filtering
Exclude specific pages from the sitemap:
sitemap({
filter: (page) =>
!page.includes('/recibido-ok') &&
!page.includes('/presupuesto'),
})
/recibido-ok - Thank you page/presupuesto - Budget form page
Why exclude these pages?
- Not meant for search engines
- No SEO value
- Private/internal pages
Generated Output
The integration generates:
public/
└── sitemap-index.xml
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://arteywebcreaciones.com/</loc>
<changefreq>daily</changefreq>
<priority>1.0</priority>
</url>
<url>
<loc>https://arteywebcreaciones.com/servicios/</loc>
<changefreq>weekly</changefreq>
<priority>0.8</priority>
</url>
<url>
<loc>https://arteywebcreaciones.com/blog/cuanto-cuesta-una-pagina-web/</loc>
<lastmod>2026-01-15</lastmod>
<changefreq>monthly</changefreq>
<priority>0.7</priority>
</url>
<!-- More URLs... -->
</urlset>
Sitemap Reference
Include sitemap reference in HTML:
<!-- In <head> section -->
<link rel="sitemap" href="/sitemap-index.xml" />
src/layouts/Layout.astro:
---
const sitemap = "/sitemap-index.xml";
---
<head>
<link rel="sitemap" href={sitemap} />
</head>
Advanced Filtering
Multiple Conditions
sitemap({
filter: (page) => {
// Exclude thank you pages
if (page.includes('/recibido-ok')) return false;
// Exclude internal tools
if (page.includes('/admin')) return false;
// Exclude draft pages
if (page.includes('/draft')) return false;
// Include everything else
return true;
},
})
Pattern Matching
sitemap({
filter: (page) => {
const excludePatterns = [
'/recibido-ok',
'/presupuesto',
'/admin',
'/test',
];
return !excludePatterns.some(pattern => page.includes(pattern));
},
})
Regex Filtering
sitemap({
filter: (page) => {
// Exclude pages ending with -draft or -test
return !/(draft|test)\/?$/.test(page);
},
})
Custom Sitemap Options
Change Frequency
sitemap({
changefreq: 'weekly',
priority: 0.7,
lastmod: new Date(),
})
Customize Per Page
sitemap({
customPages: [
{
url: 'https://arteywebcreaciones.com/',
changefreq: 'daily',
priority: 1.0,
},
{
url: 'https://arteywebcreaciones.com/servicios/',
changefreq: 'weekly',
priority: 0.9,
},
],
})
i18n Support
For multilingual sites:
sitemap({
i18n: {
defaultLocale: 'es',
locales: {
es: 'es-ES',
en: 'en-US',
},
},
})
Dynamic Content
Blog Posts
Blog posts from Content Collections are automatically included:
// src/pages/blog/[...slug].astro
import { getCollection } from 'astro:content';
export async function getStaticPaths() {
const posts = await getCollection('blog');
return posts.map(post => ({
params: { slug: post.slug },
props: { post },
}));
}
Filtered Blog Posts
Exclude draft posts:
export async function getStaticPaths() {
const posts = await getCollection('blog', ({ data }) => {
return data.draft !== true;
});
return posts.map(post => ({
params: { slug: post.slug },
props: { post },
}));
}
Submit Sitemap
Google Search Console
- Go to Google Search Console
- Select your property
- Navigate to Sitemaps
- Enter:
https://arteywebcreaciones.com/sitemap-index.xml
- Click Submit
- Go to Bing Webmaster Tools
- Add your site
- Submit sitemap URL:
https://arteywebcreaciones.com/sitemap-index.xml
robots.txt
Reference sitemap in public/robots.txt:
User-agent: *
Allow: /
Sitemap: https://arteywebcreaciones.com/sitemap-index.xml
Validation
XML Validator
Check sitemap validity:
# Visit your sitemap
https://arteywebcreaciones.com/sitemap-index.xml
# Or use online validator
https://www.xml-sitemaps.com/validate-xml-sitemap.html
Google Validator
Test in Google Search Console:
- Go to Sitemaps
- View submitted sitemap
- Check for errors
Troubleshooting
Sitemap Not Generated
- Verify
site is set in config
- Check build output for errors
- Ensure integration is properly installed
npm run build
# Check dist/sitemap-index.xml exists
Missing Pages
- Check page is not filtered out
- Verify page is statically generated
- Ensure page is in
src/pages/
// Debug: Remove filter temporarily
sitemap()
Wrong URLs
- Verify
site URL is correct
- Check for trailing slashes
- Ensure HTTPS in production
site: 'https://arteywebcreaciones.com' // No trailing slash
Multiple Sitemaps
For large sites, split into multiple sitemaps:
sitemap({
serialize(item) {
// Group by content type
if (item.url.includes('/blog/')) {
return {
...item,
sitemap: 'blog',
};
}
return item;
},
})
sitemap-index.xml (main index)sitemap-blog.xml (blog posts)sitemap-0.xml (other pages)
Best Practices
Update Frequency
sitemap({
changefreq: 'weekly', // Realistic update frequency
priority: 0.7, // Relative importance
})
Page Priority
Homepage: 1.0
Main sections: 0.8-0.9
Blog posts: 0.6-0.7
Other pages: 0.5
Exclude Properly
// Exclude:
- Thank you pages
- 404 pages
- Admin sections
- Draft content
- Private pages
- Runs at build time
- No runtime performance impact
- Minimal build time increase
