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:
- Clear cache:
- • Clear ProRank SEO cache (if ModernCache is enabled)
- • Clear browser cache
- • Clear CDN cache (if using Cloudflare, etc.)
- 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
Optimization 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 limits:
// Add to wp-config.php define('WP_MEMORY_LIMIT', '256M'); define('WP_MAX_MEMORY_LIMIT', '512M'); set_time_limit(300); // 5 minutes - Enable caching:Use ProRank's ModernCache for sitemap caching
HTML Sitemap Issues
Shortcode Not Working
Shortcode displays as text
- • Ensure you're adding it in the content editor, not a text widget
- • Check if shortcodes are enabled for your theme
- • Verify HTML sitemap is enabled in settings
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
-- Check sitemap settings
SELECT * FROM wp_options WHERE option_name = 'prorank_seo_sitemap_settings';
-- Find noindex posts
SELECT ID, post_title FROM wp_posts p
JOIN wp_postmeta pm ON p.ID = pm.post_id
WHERE pm.meta_key = '_prorank_seo_robots_noindex'
AND pm.meta_value = '1';
-- Count published posts
SELECT post_type, COUNT(*) as count
FROM wp_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