Deprecating Smart Components

Deprecating a Smart Component removes it from discovery: the component tray, Build Agent reach, and the default library view. All existing usages are preserved. Modules that already reference a deprecated component continue to render and behave exactly as before. Deprecation does not delete the component or break anything.

Deprecation is the recommended way to retire a Smart Component from new adoption without disrupting active modules. The component remains accessible in the Smart Component Library management surface for restoration if needed.

Deprecate a Smart Component

To deprecate a Smart Component:

1. Open the Smart Component Library.
2. Locate the component in the list.
3. Select the (ellipsis) for that component and select Deprecate.
4. Confirm the action in the dialog that displays.

The component is immediately removed from the component tray and from the Build Agent's default reach. Existing modules using the component are not affected.

Note: Only shared Smart Components are visible in the component tray and to the Build Agent. Deprecated components are excluded from discovery even if they remain shared.

What Happens to Existing Modules

Deprecating a Smart Component does not affect any module that already uses it. The component renders and behaves the same as before deprecation. Creators editing those modules will still see the component in place — it cannot be added to new modules going forward.

Find Deprecated Components

Deprecated components are hidden from the default library view. To see them:

1. Open the Smart Component Library.
2. Use the Status filter and select Deprecated (or All to see both active and deprecated components).

Restore a Deprecated Component

To make a deprecated component available for adoption again:

1. Open the Smart Component Library.
2. Filter by Status: Deprecated to locate the component.
3. Select the (ellipsis) and select Restore.

The component returns to active status and becomes visible in the component tray and to the Build Agent.