Badge Pull Requests — FOSSA Docs Docs Search docs... ⌘K
Docs API CLI Glossary
Launch App
User Guides
Product Guides
Get Started
Project Setup
CLI CI/CD Scanning Pull Request Checks Badge Pull Requests Containers Snippets Quick Import Broker Binaries SBOM Import Dependencies Package Inventory Project Settings Ignore a Dependency Project Labels Automatic Updates Archive Upload Supported Languages
Scan Frequency Notifications Issue Scanners Privacy Settings Build History and Rebuilding Mediated Dependencies
Release Groups
Issues
Licenses
Vulnerabilities
Quality
SBOM
Policies
Reports
FOSSA CLI
API Reference
Integrations
fossabot
Organization Management
On-Premises Deployment
Help & Support
Legal
Get Support fossa.com
On this page
* Overview
* Adding a badge without Quick Import
On this page
Docs Project Setup Badge Pull Requests Badge Pull Requests
Automatically add a FOSSA license-scan status badge to your GitHub README when you import a project.
1 min read Updated Aug 26, 2026 Copy link
Overview
Note
Badge PRs are available only for public GitHub repositories imported via Quick Import .
When importing a GitHub project , enable Submit badge PRs after import (public GitHub READMEs only) and FOSSA opens a pull request adding a license-scan status badge to your README as soon as the project imports. See Webpack's README for an example.
FOSSA adds a badge near the top of the README and a more detailed badge at the bottom. You never need to update it; FOSSA refreshes it automatically when the README loads, keeping it in sync with your default branch .
Expand
Adding a badge without Quick Import
For private repositories, CLI-imported projects, or any project where you want to place the badge yourself, copy the snippet from Project Settings → General → Embed Status Badge and paste it into your README manually. See Automatic Updates for details.
Expand
Previous Automatic Updates Next Binaries
© 2026 FOSSA, Inc.
[email protected]