# Filtering bundles

Entando Bundles are filterable by component, status or textual search.

# Filtering bundles by component

Entando Bundles are filterable by component from the App Builder user interface.

App Builder bundle filtering

Behind the scenes, filtering is done using the label-based filtering provided out of the box from Kubernetes.

To enable filtering of a bundle, the custom-resource representing the bundle on the Entando Cluster needs to contain the correct labels. An important note on the values to add the labels field, even if to correctly define a label in a k8s resource both the key and the value are required, from an Entando point of view only the key part of the label is used for filtering. The value could be set to anything, but our reccomendation is to use "true" for clarity and simplicity.

# Supported labels keys are:

Label entry Description

widget: "true"

The bundle contains one or more microfrontends (widgets)

plugin: "true"

The bundle contains one or more microservices (plugins)

fragment: "true"

The bundle contains one or more fragments

pageTemplate: "true"

The bundle contains one or more page templates

contentType: "true"

The bundle contains one or more content types

contentTemplate: "true"

The bundle contains one or more content templates

# Example

Here is an example of the metadata for an Entando Bundle containg micro frontends, some microservices and page templates

apiVersion: entando.org/v1
kind: EntandoDeBundle
metadata:
  name: demo-bundle
  labels:
    widget: "true"
    plugin: "true"
    pageTemplate: "true"
spec:
  details:
  ...

# Filtering bundles by status

Entando Bundles are filterable by status from the App Builder user interface.

App Builder bundle filtering

You can choose to see the full list of bundles available in the Kubernetes cluster by selecting the Explore tab, or the list of the currently installed bundles by clicking on the Installed tab.

You can search for bundles containing some keywords by executing a textual search.

App Builder bundle filtering

You can open the menu on the left to select which field to target.

If you are creating a new bundle, keep in mind the textual search is performed against data extracted from the bundle CRD file.

# Mixing search criteria

You can mix all previous search criteria to refine the scope of your search as you want. For example, you could search for all available bundles (Explore tab) that contain Page Templates components (using the checkboxes) and the word Login in their name (using the textual search).