Skip to main content

Catalog page

A catalog page displays a table of all existing entities created from a blueprint.
In this example we can see all of the cluster entities we created from the K8s Cluster blueprint:

Microservice blueprint page

Page creationโ€‹

When a blueprint is created, a catalog page is automatically generated in the Software Catalog.
You can also manually create additional catalog pages for any existing blueprint, and customize them as you wish. Read on to see the available customization options.

Initial filtersโ€‹

In some cases, an entities table may be very large, resulting in long loading times. To prevent this, you can define filters that resolve when Port queries the data (rather than after querying).
To define such a filter, use the Initial filters field when creating a page:

You can define any supported rule in JSON format. Here is an example that will only display Deployments that were updated in the past month:

"property": "$updatedAt",
"operator": "between",
"value": { "preset": "lastMonth" }


The entities table can be customized, which will define the users' view of the Port platform.


We highly recommend using these customizations to provide a clean and accurate view of the platform for your developers.

All table customizations are available on the top bar of the table:

Table operations bar


You can filter the table by using the following menu:

Table filter menu marked

You can define any filtering operator with a suitable value.

You can filter one or more values while setting the relation between each field with a And/Or.

My Teams Filterโ€‹

By using the My Teams filter you will only see entities that belong to one of your teams. This means you will only see entities from teams that you are a member of.

This filter works on:

  • string properties with the format team.
  • The meta property Team.

My Teams Filter


You can sort the table by using the following menu:

Table sort menu marked

You can sort by one or more fields of any kind.


To sort a specific column, click on the column title.


You can hide table columns by using the following menu:

Table hide menu marked

You can decide whether each field is viewable to users or not.


We highly recommend hiding irrelevant data from users, to provide them with a clean work environment, relieving them from any distractions.

Group Byโ€‹

You can group by entities by using the following menu:

Table group by menu marked

You can group results according to any field in the table.


Group by is recommended when you want to create custom views for users, such as "microservices by owners".

Just create your group by setting, add additional viewing settings if needed, and save a new page from the custom view.

Port provides a free-text search option on tables. To search a table, click here:

Table search bar marked

-> Explore how to control page visibility and permissions

Page operationsโ€‹

Each page type has a set of operations that can be performed from the UI.
The table below summarizes the available operations for every type:

Page typeSave a viewSave view as
a new page
Edit pageDelete pageLock page
Blueprint page (Default Page)โœ…โœ…โŒโŒโœ…
Custom page (manually created)โœ…โœ…โœ…โœ…โœ…
Default page

The default page is automatically generated when a new Blueprint is created. This page is directly tied to its Blueprint and cannot be edited or deleted.

In order to edit or delete the default Blueprint page, you need to edit or delete the Blueprint itself.

It's possible to filter, sort, group by, and use the table widget controls to change the layout of the default page.

Save a viewโ€‹

Every change made on a specific page, such as filtering or sorting, enables the Save this view button.
Clicking on it will save the new view for all users.

Page operations marked


The ability to save a view for all users is available only for the Admin role

Save a new pageโ€‹

Each time a change is made on a page, and the Save this view becomes enabled, you can press the small arrow on its right side to open a dropdown menu:

Save view menu button marked

After clicking the Save as a new page button, a window will pop up:

Save as a new page popup

Choose page iconโ€‹

When saving a new page or editing an existing one, a set of icons is available to you:

Page Icons dropdown menu

Edit, lock or delete a pageโ€‹

You can edit, lock or delete a page by clicking the ... button in the top right corner:

Page menu

Editing pagesโ€‹

Editing a page allows you to change its name and/or icon:

Edit Page popup window

Locking pagesโ€‹

Locking a catalog page disables the option to hide columns or apply filters to modify the displayed data.

Locking pages gives you a way to specifically curate pages to your developers' needs. This ensures that they can't modify the views or see data that isn't relevant to them.

To learn how to lock pages, refer to page permissions.

Deleting pagesโ€‹

A manually-created catalog page can be deleted by clicking the Delete page button.