Sitemaps Troubleshooting
Common sitemap issues and their solutions in ProRank SEO
Common Issues
Sitemap Returns 404 Error
Symptoms:
- • Visiting /sitemap_index.xml shows 404 page
- • Individual sitemaps not accessible
- • Search Console reports sitemap not found
Solutions:
- Flush permalinks:
Settings → Permalinks → Save Changes (without making changes) - Check if sitemaps are enabled:ProRank SEO → Technical SEO → Sitemaps → XML Sitemap tab
- Verify .htaccess file:Ensure WordPress rewrite rules are present
- Check for conflicts:Disable other SEO plugins that might generate sitemaps
Sitemap Not Updating
Symptoms:
- • New posts not appearing in sitemap
- • Deleted content still showing
- • Last modified dates not changing
Solutions:
- Check caching layers:
- • ProRank automatically invalidates its sitemap transient cache when content changes — no manual action needed
- • Clear your browser cache to see the latest version
- • Clear CDN cache (if using Cloudflare, etc.) as CDN edge nodes may serve a stale copy
- Check exclusion settings:Verify the content isn't excluded by ID or noindex
- Save settings again:Re-save sitemap settings to trigger regeneration
Missing Content in Sitemap
Common Causes:
- Content is noindexed:Check post/page SEO settings for noindex meta tag
- Post type not included:Verify in Content Types tab that post type is selected
- Content is draft/private:Only published content appears in sitemaps
- Manually excluded:Check "Exclude Posts" and "Exclude Terms" fields
- Password protected:Password-protected posts are automatically excluded
Search Console Errors
Common Google Search Console Issues
"Couldn't fetch" Error
- Check robots.txt:Ensure sitemaps aren't blocked by robots.txt
- Verify URL:Make sure you submitted the correct sitemap URL
- Test accessibility:
curl -I https://yoursite.com/sitemap_index.xml
"Invalid XML" Error
- Validate XML:Use an XML validator to check for syntax errors
- Check for HTML output:Ensure no PHP errors or HTML are being output
- Encoding issues:Verify UTF-8 encoding is used throughout
"URL not allowed" Error
- Cross-domain URLs:All URLs must be from the same domain
- Protocol mismatch:Ensure all URLs use the same protocol (http/https)
- Subdomain issues:www and non-www are treated as different domains
Performance Issues
Sitemap Generation Slow or Timing Out
Optimisation Steps:
- Reduce entries per sitemap:Lower from default 1000 to 500 or 250
- Exclude unnecessary content:
- • Remove low-value pages
- • Exclude empty categories/tags
- • Limit to essential post types
- Increase PHP memory limits:
// Add to wp-config.php define('WP_MEMORY_LIMIT', '256M'); define('WP_MAX_MEMORY_LIMIT', '512M'); - Sitemap caching:ProRank caches sitemap XML output automatically using transients (default: 1 hour). No additional configuration is needed.
HTML Sitemap Issues
Shortcode Not Working
Shortcode displays as text
- • Verify HTML sitemap is enabled in ProRank SEO → Technical SEO → Sitemaps → HTML Sitemap tab
- • If using a page builder, make sure it processes WordPress shortcodes
- • Try adding the shortcode in the default WordPress block or classic editor
Empty or incomplete display
- • Check "Include Sections" settings
- • Verify content exists for selected sections
- • Check exclusion settings aren't too restrictive
Styling issues
- • Theme CSS may conflict - add custom CSS to override
- • Check responsive settings for mobile display
- • Verify column settings are appropriate for container width
Debugging Tools
Useful Commands and Tools
Check Sitemap Accessibility
# Check HTTP status
curl -I https://yoursite.com/sitemap_index.xml
# View sitemap content
curl https://yoursite.com/sitemap_index.xml
# Check with user agent
curl -H "User-Agent: Googlebot" https://yoursite.com/sitemap_index.xmlDatabase Queries
-- Replace {prefix} with your WordPress table prefix (default: wp_)
-- Find noindex posts
SELECT ID, post_title FROM {prefix}posts p
JOIN {prefix}postmeta pm ON p.ID = pm.post_id
WHERE pm.meta_key = '_prorank_seo_noindex'
AND pm.meta_value = '1';
-- Count published posts by type
SELECT post_type, COUNT(*) as count
FROM {prefix}posts
WHERE post_status = 'publish'
GROUP BY post_type;Online Validators
Prevention Tips
Best Practices to Avoid Issues
- ✓Regular monitoring:Check Search Console weekly for sitemap errors
- ✓Test after changes:Always verify sitemaps work after plugin updates
- ✓Avoid conflicts:Don't use multiple sitemap plugins simultaneously
- ✓Keep URLs consistent:Use the same domain format (www/non-www) everywhere
- ✓Backup settings:Export ProRank SEO settings regularly
Getting Help
If you're still experiencing issues after trying these solutions, our support team is here to help.
Before Contacting Support
- • Note your WordPress version
- • Check ProRank SEO version
- • List other active plugins
- • Save any error messages
- • Test with default theme if possible