[Meta] Deprecation and Beta schedule

[snide]

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 for recommended guidelines on how to deprecate features.

Deprecation Schedule

Ongoing betas

• EuiCollapsibleNavBeta - This is dependent on Kibana changing classic to use this [Beta] EuiCollapsibleNavBeta functionality #8458
• EuiProvider componentDefaults - Should remain in beta until architecturally complete [Beta] EuiProvider componentDefaults functionality #8451
• EuiDataGrid canDragAndDropColumns - Once Discover team validates and uses this, we should consider making it the new default for data grids [Beta] EuiDataGrid canDragAndDropColumns functionality #8454
• EuiDataGrid rowHeightsOptions.autoBelowLineCount - Once Discover team validates there are no severe performance impacts we can lift it out of Beta. [Beta] EuiDataGrid rowHeightsOptions.autoBelowLineCount functionality #8456
• High Contrast Mode - [BETA] High Contrast Mode #8567

PENDING

• Remove EuiFilterSelectItem (consumers should use EuiSelectable instead) (NOTE: this requires [EuiComboBox] Rebuild with EuiSelectable #2841 first, and the deprecation date for this should be moved as necessary if not yet done)
• Remove the Amsterdam theme

December 2025

• Remove euiPaletteForLightBackground and euiPaletteForDarkBackground palette functions (#8793)

November 2025

• Remove EuiInMemoryTable's message prop (feat(eui): add noItemsMessage prop to EuiInMemoryTable #8812)

October 2025

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

March 2025

• Checkpoint on canDragAndDropColumns beta
• Checkpoint on EuiCollapsibleNavBeta beta
• Checkpoint on rowHeightsOptions.autoBelowLineCount beta

February 2025

January 2025

December 2024

• Remove EuiPopover's hasDragDrop prop ([EuiDraggable] Add support for reparenting dragged items #8048)

November 2024

• Remove EuiFormRow's display="columnCompressedSwitch" and display="rowCompressed" options ([Emotion] Convert EuiFormRow #7968)

June 2024

• Remove EuiFlyoutResizable from beta (June deprecations #7808)
• Remove euiPalettePositive and euiPaletteNegative (Use culturally inclusive palette names #7570)
• Remove EUI_CHARTS_THEME_LIGHT, EUI_CHARTS_THEME_DARK, and EUI_SPARKLINE_THEME_PARTIAL (chore: fully remove deprecated charts theming exports #7682)

March 2024

• Remove EuiTextTruncate from beta ([EuiTextTruncate] Remove beta status in docs #7639)

January 2024

• Remove anchorClassName and buttonRef props from EuiPopover ([EuiPopover] Remove 2nd unnecessary anchor div wrapper #7311)
• Remove setSelection class method from EuiBasicTable ([EuiBasicTable][EuiInMemoryTable] Support controlled selection API #7321)
• Remove toolTipTitle and toolTipPosition from EuiContextMenuItem ([EuiBasicTable][EuiInMemoryTable] Enable more action props to accept an optional callback + fix missing tooltips on collapsed actions #7373)

December 2023

• Remove EuiControlBar + close any related open issues (Deprecate EuiSuggest, EuiColorStops, EuiControlBar, and EuiNotificationEvent #7122)
• Remove EuiNotificationEvent + close any related open issues (Deprecate EuiSuggest, EuiColorStops, EuiControlBar, and EuiNotificationEvent #7122)

November 2023

• Remove euiPaletteComplimentary. Consumers should use euiPaletteComplementary

October 2023

• Remove EuiSuggest + close any related open issues (Deprecate EuiSuggest, EuiColorStops, EuiControlBar, and EuiNotificationEvent #7122)
• Remove EuiColorStops + close any related open issues (Deprecate EuiSuggest, EuiColorStops, EuiControlBar, and EuiNotificationEvent #7122)
• Remove euiHeaderAffordForFixed Sass mixin
• Remove deprecated page components [Feature] EuiPage and EuiPageTemplate Updates #5768 [Meta] EUIPage*_Deprecated Punch List kibana#161872

September 2023

• Remove isBeta flag from EuiInlineEdit component example in the docs [EuiInlineEdit] End Beta Phase #7181

August 2023

• [Docs] Remove isNew flag from EuiSkeleton component example #7021

May 2023

• Remove deprecated EuiLoadingContent (Deprecate EuiLoadingContent in favor of EuiSkeletonText #6557)

September 2022

• Remove euiCallOutColor() Sass mixin

May 2022

• Remove Popper popoverPosition options from EuiDatePicker ([EuiDatePicker] react-datepicker to src/; use EUI services #5339 (review))
• Remove PartitionConfig from Charts theme Update elastic-charts to v41.0.1 #5492
• Remove data-gridcell-id attribute from EuiDataGridCell #5515

January 2022

• Remove popoverClassName & repositionOnScroll props from EuiSuperSelect [EuiSuperSelect] Add popoverProps prop  #5214

October 2021

• Remove EuiCodeEditor ([Docs] EuiCodeEditor - Removed examples and added deprecation notice #4683)
• Remove betaBadgeLabel, betaBadgeTooltipContent, betaBadgeTitle props from EuiCard ([EuiBetaBadge] Add color and size props and support for click event #4798)
• Remove EuiLoadingKibana (New [EuiLoaderLogo] and other loader updates #4835)
• Remove secondary color prop options (Updating buttons and links to promote success over secondary color and fixed EuiButtonIcon colors #4874, Updating components to use success over secondary color option #4888)
• Remove subdued color prop option from EuiButtonIcon (Updating buttons and links to promote success over secondary color and fixed EuiButtonIcon colors #4874)
• Remove panelPaddingSize from EuiPageContent ([Page Layouts] Adding content props to EuiPageHeader for pre-determined page layout patterns #4451)
• Remove makeId (Replace makeId with htmlIdGenerator #3112)
• Remove old mobile only props from EuiTableRowCell

June 2021

• Remove EuiKeyboardAccessible Deprecating EuiKeyboardAccessible #4135 (Remove EuiKeyboardAccessible #4991)

March 2021

• Remove onClick, betaBadgeLabel, betaBadgeTooltipContent, and betaBadgeTitle props of EuiPanel (#4194)

July 2020

• EuiIcon's logoAPM type deprecated in favor of logoObservability
• .euiHeaderNotification class (Adding more props to EuiHeaderSectionItemButton, EuiFieldSearch, and EuiAccordion #2914)
• Remove disabled colors of buttons and leave it to :disabled to style it [Amsterdam] Updating button styles #2874
• Remove EuiNavDrawer in favor of EuiCollapsibleNav [Feature] Added EuiCollapsibleNav component #2977

December 2019

• EuiFormRow compressed prop in favor of display = "compressed" [Feature branch] Compressed form rows #2181
• EuiFormRow displayOnly prop in favor of display = "center" [Feature branch] Compressed form rows #2181
• EuiPopover's prop withTitle

July 2019 #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
  • Original PR with deprecation
• Remove singular mobile props for tables that are now included in the mobileOptions object.
  • Original PR with deprecation
• Any SASS deprecations

[snide]

Reminder to @cchaos. Can you add the newest deprecations into the above schedule? We can probably use the usual 6 month window?