| filename | Code Coverage file to process (with extension) | yes | — |
| github_token | GitHub token. This is sometimes needed on private repositories | no | ${{ github.token }} |
| only_list_changed_files | Only list changed files | no | false |
| markdown_filename | The filename (without extension) for the resulting markdown file. Default is code-coverage-results. | no | code-coverage-results |
| badge | Include a coverage badge in the output using shields.io - true / false (default). | no | false |
| overall_coverage_fail_threshold | Fail if overall coverage below lower threshold percentage. The default value is 0 | no | 0 |
| file_coverage_error_min | Threshold used to determine when coverages less than this value should be marked red | no | 50 |
| file_coverage_warning_max | Threshold used to determine when coverages less than this value should be marked orange. Above this will be marked green | no | 75 |
| fail_on_negative_difference | Fail if any difference is a negative value (Coverage was reduced) | no | false |
| artifact_download_workflow_names | Comma Separated list of workflow names to look for artifacts in. If left empty will only look at the current workflow | no | — |
| artifact_name | Artifact name. Use %name% as a placeholder (must be included!) | no | coverage-%name% |
| negative_difference_by | Determines how negative difference is evaluated. Possible values are "overall" and "package" (default) | no | package |
| negative_difference_threshold | The percentage drop in coverage that should be allowed. The default value is 0. | no | 0 |
| retention_days | The number of days to retain uploaded artifacts. When `undefined` (default), the default retention period for the repository is used. | no | — |
| without_base_coverage_template | Path to custom template without base coverage | no | — |
| with_base_coverage_template | Path to custom template with base coverage | no | — |
| show_coverage_by_top_dir | When true, aggregate coverage by the first path segment (e.g. src/, tests/, (root)). Takes precedence over coverage_depth and show_coverage_by_parent_dir. | no | false |
| coverage_depth | When set (e.g. 2), aggregate by path to this depth (1=first segment, 2=first two segments). Ignored if show_coverage_by_top_dir is true. Takes precedence over show_coverage_by_parent_dir. | no | "" |
| show_coverage_by_parent_dir | When true, aggregate coverage by the parent directory of each file (e.g. src/common/, src/aws/). Ignored if show_coverage_by_top_dir or coverage_depth is set. | no | false |
| exclude_paths | Comma-separated path prefixes to exclude from coverage (e.g. tests/, e2e/, docs/). Files whose relative path starts with any prefix are excluded from the report and from overall coverage. | no | "" |