actions-marketplace-validations/urlsup - URL Validator
Fast, concurrent URL validation for files in your repository using the powerful urlsup
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Maintainedlast commit Aug 10, 2025
- License
- MIT
Pinned Snippet
uses: actions-marketplace-validations/simeg_urlsup-action@7d6d25ef37fc6652c43667b5b1598f76bbcd4c37 # no releases — HEAD as of 2026-07-13tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| files | Files or directories to check (space-separated) | no | . |
| recursive | Recursively process directories | no | true |
| include-extensions | File extensions to process (comma-separated, e.g., md,html,txt) | no | md,rst,txt,html |
| timeout-seconds | Connection timeout in seconds | no | 5 |
| concurrency | Number of concurrent requests (default: CPU cores) | no | — |
| retry | Retry attempts for failed requests | no | 2 |
| retry-delay-ms | Delay between retries in milliseconds | no | 1000 |
| rate-limit-ms | Delay between requests in milliseconds | no | 100 |
| allowlist | URLs to allow (comma-separated patterns) | no | — |
| allow-status | HTTP status codes to allow (comma-separated) | no | 200,202,204 |
| exclude-pattern | URL patterns to exclude (regex) | no | — |
| allow-timeout | Allow URLs that timeout | no | false |
| failure-threshold | Failure threshold - fail only if more than X% of URLs are broken (0-100). Leave empty to fail on any broken URL (default behavior). | no | "" |
| quiet | Suppress progress output | no | false |
| verbose | Enable verbose logging | no | false |
| no-progress | Disable progress bars | no | false |
| user-agent | Custom User-Agent header | no | urlsup-action/1.0.0 (+https://github.com/simeg/urlsup-action) |
| proxy | HTTP/HTTPS proxy URL | no | — |
| insecure | Skip SSL certificate verification | no | false |
| config | Path to urlsup configuration file | no | — |
| no-config | Ignore configuration files | no | false |
| urlsup-version | Version of urlsup to use | no | 2.4.0 |
| create-annotations | Create GitHub annotations for broken URLs | no | true |
| fail-on-error | Fail the action if broken URLs are found | no | true |
| show-performance | Show performance metrics in job summaries | no | false |
Outputs
| name | description |
|---|---|
| total-urls | Total number of URLs validated |
| broken-urls | Number of broken URLs found |
| success-rate | Percentage of working URLs |
| report-path | Path to detailed JSON report |
| exit-code | Exit code from urlsup (0 = success, >0 = errors found) |
| total-files | Total number of files found |
| processed-files | Number of files processed |
| total-found-urls | Total number of URLs found in files |
| unique-urls | Number of unique URLs found |
| status | Overall validation status (success/failure) |