elastic / elastic/eui

[Meta] Deprecation and Beta schedule

Open
#1,469 1 comment 2 reactions 0 assignees View on GitHub
beta breaking change deprecations meta
Dominant language
TypeScript
Stars
6.4k
Forks
911
Avg merge
2d 11h
Merged PRs (30d)
65

Description

This is a meta ticket to cover all deprecations planned for EUI. These dates can and will be moved up if upgrades happen swiftly. Deprecations will generally be a 3 month period.

[See our deprecations wiki doc](https://github.com/elastic/eui-private/wiki/Deprecations)🔒 for recommended guidelines on how to deprecate features.

## Beta Schedule

### Ongoing betas

- EuiProvider `componentDefaults` - Should remain in beta until architecturally complete https://github.com/elastic/eui/issues/8451
- EuiDataGrid `canDragAndDropColumns` - Once Discover team validates and uses this, we should consider making it the new default for data grids https://github.com/elastic/eui/issues/8454
- EuiDataGrid `rowHeightsOptions.autoBelowLineCount` - Once Discover team validates there are no severe performance impacts we can lift it out of Beta. https://github.com/elastic/eui/issues/8456
- High Contrast Mode - https://github.com/elastic/eui/issues/8567
- EuiLiveAnnouncer - https://github.com/elastic/eui/pull/8916
- EuiButton `hasAriaDisabled` - experimental custom disabled behavior (https://github.com/elastic/eui/pull/9201)
- `euiContainer()`, `euiContainerCSS()`, `euiContainerQuery()` and `useEuiContainerQuery()` (https://github.com/elastic/eui/pull/9264, https://github.com/elastic/eui/pull/9251)
- EuiBasicTable/EuiInMemoryTable `sticky: true` on action buttons columns (https://github.com/elastic/eui/issues/9571)
- EuiTable/EuiBasicTable/EuiInMemoryTable horizontal scrolling on overflow (https://github.com/elastic/eui/issues/9572)
- EuiTable/EuiBasicTable/EuiInMemoryTable Always-visible horizontal scrollbar (https://github.com/elastic/eui/pull/9674)

## Enhancements Schedule

**Meta:** https://github.com/elastic/eui/issues/9181
**Target:** Widely available

- https://github.com/elastic/eui/issues/7102 ([caniuse](https://caniuse.com/css-anchor-positioning), Limited availability)
- https://github.com/elastic/eui/issues/9180 ([caniuse](https://caniuse.com/css-content-visibility), Newly available)

## Deprecation Schedule

### PENDING

- [ ] Remove `EuiFilterSelectItem` (consumers should use `EuiSelectable` instead) (NOTE: this requires elastic/eui#2841 first, and the deprecation date for this should be moved as necessary if not yet done)
- [ ] Remove deprecated icon aliases that are persisted: https://github.com/elastic/eui/issues/9832

### January 2027

- [ ] Remove Options API on `EuiButtonGroup` ([#9953](https://github.com/elastic/eui/pull/9953))

### October 2026

- [ ] Remove deprecated icon aliases: https://github.com/elastic/eui/issues/9847

### July 2026

- [ ] Remove `pushAnimation` prop from `EuiFlyout` ([#9428](https://github.com/elastic/eui/pull/9428))
- [ ] Remove `hideTitle` from `EuiFlyoutMenuProps` ([#9502](https://github.com/elastic/eui/pull/9502))
- [x] Remove deprecated icons from EUI code base (https://github.com/elastic/eui/issues/9561)

---

Archive of completed deprecations

### December 2025

- [x] Remove `euiPaletteForLightBackground` and `euiPaletteForDarkBackground` palette functions ([#8793](https://github.com/elastic/eui/pull/8793))

### November 2025

- [x] Remove `EuiInMemoryTable`'s `message` prop (#8812)

### October 2025

Lift High Contrast mode from beta - It would have been in product for 2 full release cycles at this point.

- [x] Remove the [Amsterdam](https://github.com/elastic/eui/issues/8651) theme (https://github.com/elastic/eui/issues/9084)

### March 2025

- Checkpoint on `canDragAndDropColumns` beta
- Checkpoint on `EuiCollapsibleNavBeta` beta
- Checkpoint on `rowHeightsOptions.autoBelowLineCount` beta

### February 2025

### January 2025

### December 2024

- [x] Remove `EuiPopover`'s `hasDragDrop` prop (#8048)

### November 2024

- [x] Remove `EuiFormRow`'s `display="columnCompressedSwitch"` ~and `display="rowCompressed"`~ options (#7968)

### June 2024

- [x] Remove `EuiFlyoutResizable` from beta (#7808)
- [x] Remove `euiPalettePositive` and `euiPaletteNegative` (#7570)
- [x] Remove `EUI_CHARTS_THEME_LIGHT`, `EUI_CHARTS_THEME_DARK`, and `EUI_SPARKLINE_THEME_PARTIAL` (#7682)

### March 2024

- [x] Remove `EuiTextTruncate` from beta (https://github.com/elastic/eui/pull/7639)

### January 2024

- [x] Remove `anchorClassName` and `buttonRef` props from `EuiPopover` (#7311)
- [x] Remove `setSelection` class method from `EuiBasicTable` (#7321)
- [x] Remove `toolTipTitle` and `toolTipPosition` from `EuiContextMenuItem` (#7373)

### December 2023

- [x] Remove `EuiControlBar` + close any related open issues (#7122)
- [x] Remove `EuiNotificationEvent` + close any related open issues (#7122)

### November 2023

- [x] Remove `euiPaletteComplimentary`. Consumers should use `euiPaletteComplementary`

### October 2023

- [x] Remove `EuiSuggest` + close any related open issues (#7122)
- [x] Remove `EuiColorStops` + close any related open issues (#7122)
- [x] Remove `euiHeaderAffordForFixed` Sass mixin
- [x] Remove deprecated page components elastic/eui#5768 https://github.com/elastic/kibana/issues/161872

### September 2023

- [x] Remove `isBeta` flag from `EuiInlineEdit` component example in the docs elastic/eui#7181

### August 2023

- [x] elastic/eui#7021

### May 2023

- [x] Remove deprecated `EuiLoadingContent` (#6557)

### September 2022

- [x] Remove `euiCallOutColor()` Sass mixin

### May 2022

- [x] Remove Popper `popoverPosition` options from **EuiDatePicker** (https://github.com/elastic/eui/pull/5339#pullrequestreview-802994750)
- [x] Remove `PartitionConfig` from Charts theme elastic/eui#5492
- [x] Remove `data-gridcell-id` attribute from **EuiDataGridCell** [#5515](https://github.com/elastic/eui/pull/5515/commits/f444d5610681428839512ac41fe2c7dd25a4686a)

### January 2022

- [x] Remove `popoverClassName` & `repositionOnScroll` props from **EuiSuperSelect** elastic/eui#5214

### October 2021

- [x] Remove **EuiCodeEditor** (#4683)
- [x] Remove `betaBadgeLabel`, `betaBadgeTooltipContent`, `betaBadgeTitle` props from **EuiCard** (#4798)
- [x] Remove **EuiLoadingKibana** (#4835)
- [x] Remove `secondary` color prop options (#4874, elastic/eui#4888)
- [x] Remove `subdued` color prop option from **EuiButtonIcon** (#4874)
- [x] Remove `panelPaddingSize` from **EuiPageContent** (#4451)
- [x] Remove `makeId` (#3112)
- [x] Remove old mobile only props from [**EuiTableRowCell**](https://share.getcloudapp.com/Qwu2e7kG)

### June 2021

- [x] Remove `EuiKeyboardAccessible` elastic/eui#4135 (#4991)

### March 2021

- [x] Remove `onClick`, `betaBadgeLabel`, `betaBadgeTooltipContent`, and `betaBadgeTitle` props of **EuiPanel** ([#4194](https://github.com/elastic/eui/pull/4194))

### July 2020

- `EuiIcon`'s `logoAPM` type deprecated in favor of `logoObservability`
- `.euiHeaderNotification` class (#2914)
- Remove `disabled` colors of buttons and leave it to `:disabled` to style it elastic/eui#2874
- Remove `EuiNavDrawer` in favor of `EuiCollapsibleNav` elastic/eui#2977

### December 2019

- EuiFormRow `compressed` prop in favor of `display = "compressed"` elastic/eui#2181
- EuiFormRow `displayOnly` prop in favor of `display = "center"` elastic/eui#2181
- EuiPopover's prop `withTitle`

### July 2019 https://github.com/elastic/eui/pull/2108

* `EuiSeriestChart` will be end of lifed. This was a beta component with only minor usage across Elastic. It will be replaced by a charting library that lives outside of EUI that is soon to be released.
* [Updated docs](https://elastic.github.io/eui/#/charts-deprecated/general)
* [Original PR with deprecation](https://github.com/elastic/eui/pull/1463)
* Remove singular mobile props for tables that are now included in the `mobileOptions` object.
* [Original PR with deprecation](https://github.com/elastic/eui/pull/1462)
* Any SASS deprecations

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.