• arrow-switch
• file-badge
• x-circle, x-circle-fill, circle

• Corrected positioning for triangle-down #459

• Dependency updates

• We've given Octicons a new look ✨ Some icons have new names and some icons haven't been redesigned yet. The following table documents those changes. If you're using an octicon in v9.x that doesn't have an equivelent in v10.0 yet, let us know by opening an issue.

• We designed a set of 24px icons—as well as 16px icons—to accommodate interfaces that need larger icons. All package implementations now choose which SVG to render based on the size passed in.

• Icon components (e.g. AlertIcon, ArrowRightIcon, etc.) now accept size, ariaLabel, verticalAlign, and className props and can be used on their own. No need to pass them to the Octicon component.

  <AlertIcon size={24} />

• Icon components will now choose the best SVG icon to render based on the size passed in.

• The Octicon component is deprecated. Use icon components on their own instead:

  - <Octicon icon={AlertIcon} />
  + <AlertIcon />

• All icon component names now include Icon at the end (e.g. Alert → AlertIcon).

• In order to enable tree-shaking, we removed the iconsByName and getIconByName exports.

• Octicon no longer accepts width or height props. Use the size prop instead. In cases where the width and height of an icon are not equal (e.g. logos), the height will be set to the value of the size prop and the width will be scaled proportionally.

• We renamed the ariaLabel prop to aria-label to be consistent with React: https://reactjs.org/docs/accessibility.html#wai-aria

  - <AlertIcon ariaLabel="alert">
  + <AlertIcon aria-label="alert">

• Setting verticalAlign="top" on the Octicon component or any icon component will now apply a vertical-align: top; style to the <svg>. Previously, we were translating "top" to "text-top." So setting verticalAlign="top" would apply a vertical-align: text-top; style to the <svg>. If you want a vertical alignment of "text-top," set the verticalAlign prop to "text-top".

• Custom icon components passed to the Octicon component now need to render the entire <svg>, not just the <path>.

function CirclesIcon() {
  return (
-   <React.Fragment>
+   <svg viewBox="0 0 30 10" width="30" height="10">
      <circle r={5} cx={5} cy={5}/>
      <circle r={5} cx={15} cy={5}/>
      <circle r={5} cx={25} cy={5}/>
-   </React.Fragment>
+   </svg>
  )
}

- CirclesIcon.size = [30, 10]

• The structure of each icon object has been updated to allow support multiple SVGs per icon:

octicons.alert
// {
//     symbol: 'alert',
//     keywords: ['warning', 'triangle', 'exclamation', 'point'],
//     toSVG: [Function],
//     width: 16,
//     height: 16,
//     path: '<path d="M8.865 1.52c-.18-.31-.51-.5-.87-.5s-.69.19-.87.5L.275 13.5c-.18.31-.18.69 0 1 .19.31.52.5.87.5h13.7c.36 0 .69-.19.86-.5.17-.31.18-.69.01-1L8.865 1.52zM8.995 13h-2v-2h2v2zm0-3h-2V6h2v4z"/>',
//     options: {
//         version: '1.1',
//         width: '16',
//         height: '16',
//         viewBox: '0 0 16 16',
//         class: 'octicon octicon-alert',
//         'aria-hidden': 'true'
//     },
// }

octicons.alert
// {
//     symbol: 'alert',
//     keywords: ['warning', 'triangle', 'exclamation', 'point'],
//     toSVG: [Function]
//     heights: {
//         16: {
//             width: 16,
//             path: '<path d="M8.865 1.52c-.18-.31-.51-.5-.87-.5s-.69.19-.87.5L.275 13.5c-.18.31-.18.69 0 1 .19.31.52.5.87.5h13.7c.36 0 .69-.19.86-.5.17-.31.18-.69.01-1L8.865 1.52zM8.995 13h-2v-2h2v2zm0-3h-2V6h2v4z"/>',
//             options: {
//                 version: '1.1',
//                 width: '16',
//                 height: '16',
//                 viewBox: '0 0 16 16',
//                 class: 'octicon octicon-alert',
//                 'aria-hidden': 'true'
//             },
//         },
//         24: ...
//     }
// }

• New icon north-star primer#380

• New icon internal-repo primer#375

• New icons heart-outline infinity line-arrow-up line-arrow-down line-arrow-right line-arrow-left primer#365

• Contributing docs updates and issue template updates #367

• Update heart glyphs removing extra points primer#365

• Workflow icon had a cutoff edge.

• Workflow icons primer#356 @ashygee
• Allow 'unset' value for verticalAlign property primer#354 @Fs00

• New icons for save/unsave and primitive dot stroke primer#351 @ashygee @colinkeany

• Migrating to new yml actions syntax primer#332 @max & @jonrohan
• Update jekyll gemspec to support Jekyll 4.0 primer#347 @ntotten

• Octicons react isn't including className primer#271 @pocke

• renamed the original shield icon to shield-lock primer#323 @ashygee
• test for duplicate icons primer#322 @jonrohan

• Adding skip icon primer#318 @ashygee

• Rename octicons to @primer/octicons primer#311
• Rename @githubprimer/octicons-react to @primer/octicons-react primer#311

• Adding a shield icon primer#310 @ashygee @donokuda
• Adding new repo icons primer#316 @superbryntendo

• a11y aria-hidden update from @muan primer#295
• Verified icons poor rendering. @ashygee primer#297
• Docs update for contributing @ashygee primer#298

• Thumbs up/down icons needed some vector improvements. primer#287

• Node package missing build/build.css file. primer#292

• Rollup files missing from octicons react package primer#282

• Using Actions to build and deploy Octicons primer#276

• Jon Rohan (jonrohan)

• New "changes requested" icon primer#267
• Contrib Doc Updates primer#256
• Updating licenses to 2019 primer#272

• Add fold-up and fold-down icons, courtesy of @pmarsceill

• Add eye-closed icon, courtesy of @colinkeany

• Patch release for failed 8.1.1 release

• Fix for list-ordered icon primer#252
• In React Octicons, we set aria-hidden to false if there's an aria-label provided

• Add the arrow-both icon courtesy of @venetucci
• TypeScript types are now available thanks to @j-f1!
• Fix CI builds for outside contributors (as long as they aren't changing octicons)
• Fix typo in README
• Update README with @githubprimer/octicons-react scope
• Publish release candidates from any branch beginning with release

• Breaking changes in octicons_react #225
• After the initial release of octicons_react https://github.com/primer/octicons/releases/tag/v7.4.0, we needed to rename the scope of the package. Due to some deployment conflicts in our pipelines.

• This release marks the first official version of Octicons for React! Check out the @github/octicons-react package on npm for more info, or peruse the long-running PR #222.
• CI status is now reported to the #design-ops Slack channel
• Jekyll Octicons has moved in this repo from lib/jekyll-octicons to lib/octicons_jekyll

• Fix for heart icon primer#211
• Adding an archive icon created by @colinkeany
• Fixes primer#182
• Fixed versioning strategy https://github.com/primer/octicons/pull/#208

• Removing file-text and mail-reply icons. Use file and reply respectively.
• Removing spritesheet calls and toSVGUse method.

• Removing file-text and mail-reply icons. Use file and reply respectively.
• Removing spritesheet calls and to_svg_use method.

Fixes:

• Typo kebab-veritcal becomes kebab-vertical

Added:

• kebab-horizontal and kebab-vertical icons
• Polyfill for the Object.assign function

Removes:

• Removing a duplicate ellipses icon from the set. Use ellipsis instead.

Fixes:

• projects icon renders as a block, using fill-rule fixes it

Adds:

• project
• note
• screen-full
• screen-normal
• More node.js api endpoints for accessing icons primer#120
• Creating a spritesheet demo primer#121

Removes:

• Deprecating support for the webfont primer#117
• Stop checking /build/ directory into repository primer#118
• Removing sass as a dependency primer#119

Adds:

• svg.json file that is accessible from node require

Fixes:

• Vertical alignment on italic

Modifies:

• person
• organization

Fixes:

• Removing inline sourcemap from min versions of css.

Adds:

• Keywords.json file that has an index of all octicons with alias names

Fixes:

• Putting the $octicons-font-path back in the scss file.

Adds:

• Installation docs primer#94
• grabber
• plus-small

Modifies:

• smiley

Refines:

• Renames mail-reply to reply and refines its shape.

Fixes:

• Revert license back to SPDX standard

Adds:

• Whole new grunt build system including svg sprite sheet.
• adding css min primer#60
• adding woff2 format primer#3
• creates spritesheet of svg files primer#88

Removes:

• Bower support

Fixes:

• all svg icons include viewBox primer#87
• license in package.json primer#85

Adds:

• unverified

Refines:

• verified

This includes various SVG viewport refinements.

Refines:

• thumbs-down
• logo-github

Adds:

• verified
• smiley

Removes:

• color-mode

Refines:

• primitive-dot
• horizontal-rule
• triangle-down
• triangle-up
• triangle-left
• triangle-right
• globe
• flame
• comment-discussion

Adds:

• logo-gist

Resizes all our SVG to be 16x16 instead of 1024x1024

Adds:

• bold
• text-size
• italic
• tasklist

It also normalizes some styling in:

• list-unordered
• list-ordered
• quote
• mention
• bookmark
• threebars

Removes

• screen-normal
• screen-full

Adds

• shield

This thickens stroke widths slightly on the following icons:

• circle-slash
• clock
• cloud-upload
• cloud-download
• dashboard
• info
• issue-closed
• issue
• issue-reopened
• history
• question
• search

Fills comment-discussion

Thickens x to match checkmark

Some files were missing in 3.0.0

Removes

• microscope
• beer
• split
• puzzle
• steps
• podium
• timer
• all alignment icons
• all move icons
• all playback icons
• all jump icons

Adds

• beaker
• bell
• desktop-download
• watch

Line-weight changes, sizing normalization, and new drawings

• circle-slash
• lock
• cloud-upload
• cloud-download
• plus
• ✕
• broadcast
• lock
• all repo icons
• organization
• person
• all chevrons & triangles
• all diff icons
• clippy
• all issue and circular icons
• rss
• ruby
• cancel
• settings
• mirror
• external-link
• history
• gear
• settings
• info
• history
• package
• gist-secret
• rocket
• law
• telescope
• search
• tag
• normal-screen
• iphone
• no-new-line
• desktop
• all git icons
• circuit-board
• heart
• home
• briefcase
• wiki
• bookmark
• briefcase
• calendar
• color-mode
• comment
• discussions
• credit-card
• dashboard
• camera
• video
• bug
• desktop
• ellipses
• eye
• all files & folders
• fold
• unfold
• gift
• graph
• hubot
• inbox
• jersey
• keyboard
• light-bulb
• link
• location
• mail
• mail-read
• marker
• plug
• mute
• pencil
• push-pin
• fullscreen
• unfullscreen
• server
• sign-in
• sign-out
• tag
• terminal
• thumbs-up
• thumbs-down
• trash
• unmute
• versions
• gist
• key
• megaphone
• checklist

• Add the scss file I forgot to include

• Add octicons.scss
• Revert path changes to sprockets-octicons.scss, as they broke octicons in sprockets.

• Add a path variable to sprockets-octicons.scss to be consistent with octicons.less`

• Use SPDX license identifiers in package.json

Fixes file icons for

• file-binary
• file-code
• file-media
• file-pdf
• file-symlink-file
• file-text
• file-zip

• Fix vector artifact and smooth curves in mark-github

• Add two new icons: thumbsup and thumbsdown

• Add mention of github.com/logos to the license

• Hello world