| site_url | Public base URL of the site, e.g., https://example.com. Required when running from other repositories. | yes | — |
| public_dir | Directory containing the built site files. Defaults to dist (most common for modern build tools). Examples: dist, public, build, out, _site | no | dist |
| sitemap_output_dir | Directory to write sitemap files (XML, TXT, GZIP). Defaults to public_dir. | no | — |
| include_patterns | Comma-separated glob patterns to include (relative to public_dir) | no | **/*.html,**/*.htm |
| exclude_patterns | Comma-separated glob patterns to exclude (relative to public_dir) | no | **/*.map |
| exclude_urls | Comma-separated list of URLs to exclude from sitemap (exact match or pattern) | no | */sitemap*.xml,*/sitemap*.txt,*/sitemap*.xml.gz |
| exclude_extensions | Comma-separated list of file extensions to exclude (e.g., .zip,.exe,.dmg). Note: Google can index many file types including PDFs - see https://developers.google.com/search/docs/crawling-indexing/indexable-file-types | no | .zip,.exe,.dmg,.pkg,.deb,.rpm,.tar,.gz,.7z,.rar,.iso |
| additional_urls | Comma-separated list of extra absolute URLs to include | no | — |
| gzip | Whether to also emit gzip-compressed sitemap files | no | true |
| lastmod_strategy | Source for <lastmod> tag (optional per sitemaps.org): Date of last modification in W3C Datetime format. git=git commit time | filemtime=file modification time | current=build time | none=omit tag. Note: Should reflect when the linked page was last modified, not when sitemap is generated. | no | git |
| changefreq | <changefreq> tag (optional per sitemaps.org): How frequently the page is likely to change. Valid values: always, hourly, daily, weekly, monthly, yearly, never. Note: Considered a hint, not a command to search engines. | no | — |
| priority | <priority> tag (optional per sitemaps.org): Priority of URLs relative to other URLs on your site. Valid values: 0.0 to 1.0 (default 0.5). Note: Only affects priority on YOUR site, not compared to other sites. | no | — |
| sitemap_filename | Filename for the main sitemap (must be XML format per sitemaps.org protocol, UTF-8 encoded, max 50MB uncompressed, max 50,000 URLs) | no | sitemap.xml |
| allow_autodetect | Enable auto-detection of site_url/public_dir when not provided | no | true |
| prefer_company_name | Optional company/brand name to include in logs and meta (no functional impact) | no | — |
| parse_canonical | Parse HTML files to use <link rel=canonical> for URL normalization | no | true |
| discover_links | Discover internal links from HTML <a href> to include pages beyond glob matches | no | true |
| generate_sitemap_xml | Generate XML format sitemap (default sitemap.xml) | no | true |
| generate_sitemap_txt | Generate TXT format sitemap per sitemaps.org protocol: One URL per line, UTF-8 encoding, max 50,000 URLs, max 50MB | no | true |
| generate_sitemap_gzip | Generate gzip-compressed version of XML sitemap (sitemap.xml.gz) | no | true |
| validate_output | Run validation: ensure sitemaps are under recommended size | no | true |
| strict_validation | If true, fail the job when validation issues are found. Recommended: true for CI/CD to catch issues early. | no | true |
| validate_sitemaps | Comma-separated list of paths to existing sitemaps to validate (XML, TXT, or sitemap index files). Use this to validate sitemaps without generating new ones. | no | — |
| debug_list_files | Debug: List all files being processed | no | false |
| debug_list_canonical | Debug: List all parsed canonical URLs | no | false |
| debug_list_urls | Debug: List all URLs included in the sitemap | no | false |
| debug_show_sitemap | Debug: Display generated sitemap.xml content | no | false |
| debug_show_sitemap_txt | Debug: Display generated sitemap.txt content | no | false |
| debug_show_exclusions | Debug: Display all excluded files and URLs | no | false |
| upload_artifacts | Upload generated files as GitHub artifacts. | no | true |
| artifact_name | Name of the GitHub artifact when upload_artifacts is enabled | no | sitemap-files |
| artifact_retention_days | Number of days to retain the artifact (1-90). Leave empty for default (35 days) | no | — |