Files
backstage/plugins/org-react
Marat Dyatko 5f9a531412 Replace deprecated humanizeEntityRef with Catalog Presentation API
Migrate all humanizeEntityRef and humanizeEntity usages to the Catalog
Presentation API across catalog, catalog-react, org-react,
catalog-import, scaffolder, and techdocs plugins.

- Use useEntityPresentation hook in React component contexts
  (AncestryPage)
- Use defaultEntityPresentation for non-React contexts like sort
  comparators, filter functions, and data mappers
- Add @deprecated tags to humanizeEntityRef and humanizeEntity
- Improve TSDoc on entityPresentationApiRef, EntityPresentationApi,
  useEntityPresentation, EntityDisplayName, and
  defaultEntityPresentation with guidance on which to use when
- Add Entity Presentation docs page with usage examples and migration
  guide

Made-with: Cursor

Signed-off-by: Marat Dyatko <maratd@spotify.com>
2026-03-26 08:59:43 +01:00
..
2026-03-24 14:54:00 +00:00
2026-03-24 14:54:00 +00:00

org-react

features

  • Group list picker component

GroupListPicker

The GroupListPicker component displays a select box which also has autocomplete functionality.

To use the GroupListPicker component you'll need to import it and add it to your desired place.

+ import { GroupListPicker } from '@backstage/plugin-org-react';
+ import { useState } from 'react';

+ const [group, setGroup] = useState<GroupEntity | undefined>();

 <Grid container spacing={3}>
    <Grid item xs={12}>
+     <GroupListPicker groupTypes={['team']} placeholder='Search for a team' onChange={setGroup} defaultValue='Team A'/>
    </Grid>
 </Grid>

The GroupListPicker comes with four props:

  • groupTypes: gives the user the option which group types the component should load. If no value is provided all group types will be loaded in;
  • placeholder: the placeholder that the select box in the component should display. This might be helpful in informing your users what the functionality of the component is.
  • onChange: a prop to help the user to give access to the selected group
  • defaultValue: gives the user the option to define a default value that will be shown initially before making a selection