Download your first
Home › How It Works › Contribute
Workflow

Contribute

Add or refine symbols by submitting icon proposals, accessibility edits, or new icon sets via open pull requests.

Propose new symbols or edits by opening an issue first for community discussion. Once consensus forms, authors submit pull requests against the design repo, with guidance on accessibility, contrast, and semantic clarity. Proposals must reference relevant standards to ensure consistency with best practices.

Accessibility improvements—such as updating icon roles, adding fallback labels, or revising high-contrast variants—are treated as high-priority. Reviewers check against real user needs and keyboard navigation paths, not just visual appearance. Changes go live after passing automated and manual accessibility checks.

Icon set additions undergo same-process review: proposals include use cases, reference links, and testing notes. Sets are grouped by domain—like consumer, scientific, or navigational—to avoid overlap. All accepted contributions become part of the open, license-tracked repository for downstream use.

More in How It Works

See all →
Integrate

Integrate

Automate symbol updates into your build pipeline using GitHub Actions or npm scripts for reliable, repeatable workflows.

Get in touch

Questions or ideas about commonsymbols.com? Send a note and we will get back to you.

Get in touch