5.1.0

What's Changed

• v5: Update all dependency versions by @csandman in #372
• feat: Update default menu placement to "auto" by @csandman in #373

This change is to match the default flipping behavior of all Chakra UI popovers out of the box, and to align with the behavior in v6. This could be seen as a "breaking" change to some if you were reliant on the old behavior, so if you want to go back to the old behavior of having the select menu always stay below the input, pass the prop menuPlacement="bottom" to your select.

Full Changelog: v5.0.5...v5.1.0

6.1.1

What's Changed

• chore: Update all dependencies and add eslint-plugin-unicorn by @csandman in #371

Full Changelog: v6.1.0...v6.1.1

---

This was released November 14, 2025, I just forgot to create the actual release 😅

5.0.5

What's Changed

• chore: Remove the @deprecated doc tag from the style prop by @csandman in #368
• chore: Update ESLint to v9 to match the latest version of this package by @csandman in #369

Full Changelog: v5.0.4...v5.0.5

6.1.0

What's Changed

• feat: Change selectedOptionColorPalette values pulled from the theme by @csandman in #364
  • Instead of using colorPalette.300 and colorPalette.500 for the selected option background colors, the semantic token colorPalette.solid will be used instead. And for the option label, the text color will be colorPalette.contrast.
• Update type definitions for color palette props to allow for more than just the generated ColorPalette type by @saalto-it in #362
• Update all dependencies in main package and demo by @csandman in #363
• [ImgBot] Optimize images by @imgbot in #365

New Contributors

• @saalto-it made their first contribution in #362

Full Changelog: v6.0.1...v6.1.0

5.0.4

What's Changed

• chore: Update React/React DOM dependency ranges by @csandman in #360
  • This fully fixes #356, as you won't need to install React 19 using --legacy-peer-deps anymore.

Full Changelog: v5.0.3...v5.0.4

5.0.3

What's Changed

• [v5] Libraries - Update react-select to 5.10.0 by @rmanganiello in #357
• chore: Update dev dependencies by @csandman in #358

New Contributors

• @rmanganiello made their first contribution in #357

Full Changelog: v5.0.2...v5.0.3

6.0.1

What's Changed

• [ImgBot] Optimize images by @imgbot in #349
• fix: Re-add relative positioning to MenuList by @csandman in #355
• Clean up the docs and improved the demo

Full Changelog: v6.0.0...v6.0.1

6.0.0

Finally, a Chakra V3 compatible version of Chakra React Select is ready to go! There were many breaking changes in the V3 release of Chakra UI, so this version took a while, but it's now ready for use in production. Thanks to everyone who tested out the pre-releases and gave feedback.

The docs should be fully updated, but if anything doesn't make sense after the release, don't hesitate to post an issue or a discussion. Unfortunately, due to the size of this release, there won't be a codemod available for migrating (similar to the core Chakra library). Here are all of the breaking changes that should be noted when upgrading.

Breaking Changes

• Most of the styles pulled from the theme are now using styles from Chakra's new Select component.
  • The exceptions are the Control, which still uses styles from the Input theme, and the MultiValue components, which still pull their styles from the Tag theme. The docs have been updated to list out which theme styles are being used for each React Select sub-component: https://github.com/csandman/chakra-react-select#theme-styles.
• Everything that was previously named colorScheme is now named colorPalette: https://www.chakra-ui.com/docs/get-started/migration#colorscheme-prop
  • tagColorScheme is now tagColorPalette.
  • selectedOptionColorScheme is now selectedOptionColorPalette.
  • An individual option's colorScheme key is now colorPalette.
• Some props were replaced on chakraComponents.LoadingIndicator:
  • emptyColor is now trackColor (this isn't a real prop, but it maps to the --spinner-track-color css variable).
  • speed is now animationDuration.
  • thickness is now borderWidth.
  • The prop colorPalette was also added to the loading indicator which can be used to set the color without specifying a token number (responds better to changes between light and dark mode).
• The LoadingIndicator component no longer changes size in response to changes to the root size prop. With the new default size, the default spinner size ended up looking the best across all three select sizes.
• focusBorderColor was replaced with focusRingColor and errorBorderColor was removed, as there is no longer any equivalent prop that exists.
• All boolean props have had the is prefix removed: https://www.chakra-ui.com/docs/get-started/migration#boolean-props
  • isRequired is now the required attribute that's already built-in to react-select. It will behave the same as the required prop on any other Chakra component.
  • isReadOnly is now readOnly
  • isInvalid is now invalid. This prop was removed from the core Input, Select, and Textarea components in the Chakra UI library in favor of passing them into a wrapping Field.Root. However, they were left on this package due to many users not always wrapping the Select: https://www.chakra-ui.com/docs/get-started/migration#input-select-textarea
  • Adds disabled, which will override the isDisabled prop built-in to react-select
    • This is just to keep the props consistent with the other Chakra prop names. The isDisabled prop from React Select will still function as it did previously.
• Add a default for the menuPlacement of "auto". This is to more closely match the default flipping behavior of the Chakra Select.

---

One other change to note is that most of the other custom StackBlitz demos were removed from the readme. These were very time consuming to maintain, so they were removed to prevent confusion. However, most of the advanced examples were added to the main demo, so if you'd like to see how any of them have changed, you can check there.

The main demo is now a direct copy of the demo project included in this repo. This should make maintenance much easier going forward, as this will always be the basis for testing future changes.

---

Full Changelog: v5.0.2...v6.0.0

5.0.2

What's Changed

Mostly some documentation/CI changes, along with a new build config.

• feat: Add a demo vite app by @csandman in #344
  • Added a new local demo app for testing. See the Contributing doc for more info.
  • Added a new build action for previewing PR changes.
• Improve the exports and modify the tsup build config by @csandman in #346
  • Update exports to include specific types paths for import and require.
  • Changed build config to stop minifying the output and building source maps.

Full Changelog: v5.0.1...v5.0.2

5.0.1

What's Changed

• Removes support for the isFixed attribute on options to remove the tag close button. This was supposed to be removed with the other breaking changes, but it was missed.
  • The original idea for this feature was taken from an example in the react-select docs for how you can use custom components. Because of this, this should be done by the end user if desired.

Full Changelog: v5.0.0...v5.0.1