---
name: cli-cli_catalog
title: Searching and managing the IBM Cloud catalog (ibmcloud catalog)
description: Use the following commands from the IBM Cloud® Command Line Interface to manage the IBM Cloud catalog entries and geolocations of data centers.
last-updated: 2026-08-17
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/cli?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Searching and managing the IBM Cloud catalog (ibmcloud catalog)
{: #ibmcloud_catalog}

Use the following commands from the IBM Cloud® Command Line Interface to manage the IBM Cloud catalog entries and geolocations of data centers.
{: shortdesc}

You can use more CLI commands and capabilities for catalogs. Use the Catalogs management CLI plug-in to manage your private catalogs and onboard new private software. For more information, see the [Catalogs management CLI plug-in](https://cloud.ibm.com/docs/cli?topic=cli-manage-catalogs-plugin&format=markdown). 
{: note}
  
## ibmcloud catalog entry
{: #ibmcloud_catalog_entry}

Get a catalog entry:
```bash
ibmcloud catalog entry ID [--children] [--global]
```
{: codeblock}

### Command options
{: #ibmcloud_catalog_entry_options}

--children
:   Get all children for the catalog entry

--global
:   Operate in global scope

### Examples
{: #ibmcloud_catalog_entry_examples}

Get entry with ID `a0ef1-d3b4j0`:
```bash
ibmcloud catalog entry 'a0ef1-d3b4j0'
```
{: codeblock}

## ibmcloud catalog entry-create
{: #ibmcloud_catalog_entry_create}

Create a catalog entry (catalog admin of an account only):
```bash
ibmcloud catalog entry-create [-c PARAMETERS_AS_JSON] [-p, --parent PARENT] [--global]
```
{: codeblock}

### Command options
{: #ibmcloud_catalog_entry_create_options}

-p, --parent
:   Parent ID of the object

-c
:   Valid JSON object that contains catalog-specific configuration parameters, provided either inline or in a file. For a list of supported configuration parameters, see the documentation for the particular catalog entry.

--global
:   Operate in global scope

### Examples
{: #ibmcloud_catalog_entry_create_examples}

Create resource from JSON file with parent ID `a0ef1-d3b4j0`:
```bash
ibmcloud catalog entry-create -c @entry.json -p 'a0ef1-d3b4j0'
```
{: codeblock}

## ibmcloud catalog entry-update
{: #ibmcloud_catalog_entry_update}

Update an existing catalog entry (catalog admin or editor of an account only):
```bash
ibmcloud catalog entry-update ID [-c PARAMETERS_AS_JSON] [--global]
```
{: codeblock}

### Command options
{: #ibmcloud_catalog_entry_update_options}

-c
:   Valid JSON object that contains catalog-specific configuration parameters, provided either inline or in a file. For a list of supported configuration parameters, see the documentation for the particular catalog entry.

--global
:   Operate in global scope

### Examples
{: #ibmcloud_catalog_entry_update_examples}

Update resource `j402-dnf1i` from JSON file:
```bash
ibmcloud catalog entry-update 'j402-dnf1i' -c update
```
{: codeblock}

## ibmcloud catalog entry-delete
{: #ibmcloud_catalog_entry_delete}

Delete a catalog entry(catalog admin of an account only)
```bash
ibmcloud catalog entry-delete ID [--global]
```
{: codeblock}

### Command options
{: #ibmcloud_catalog_entry_delete_options}

--global
:   Operate in global scope

### Examples
{: #ibmcloud_catalog_entry_delete_examples}

Delete resource `j402-dnf1i`:
```bash
ibmcloud catalog delete `j402-dnf1i`
```
{: codeblock}

## ibmcloud catalog entry-visibility
{: #ibmcloud_catalog_entry_visibility}

Get the visibility for a catalog entry(catalog admin of an account only)
```bash
ibmcloud catalog entry-visibility ID [--global]
```
{: codeblock}

### Command options
{: #ibmcloud_catalog_entry_visibility_options}

--global
:   Operate in global scope

### Examples
{: #ibmcloud_catalog_entry_visibility_examples}

Get visibility of resource `j402-dnf1i` in global scope:
```bash
ibmcloud catalog entry-visibility 'j402-dnf1i' --global
```
{: codeblock}

## ibmcloud catalog entry-visibility-set
{: #ibmcloud_catalog_entry_visibility_set}

Update the visibility of an existing catalog entry(catalog admin of an account only):
```bash
ibmcloud catalog entry-visibility-set ID [--includes-add LIST] [--includes-remove LIST] [--excludes-add LIST] [--excludes-remove LIST] [--owner ID or Email] [--restrict] [--unrestrict] [-c PARAMETERS_AS_JSON] [--global]
```
{: codeblock}

### Command options
{: #ibmcloud_catalog_entry_visibility_set_options}

--includes-add
:   Adding an account (or list of comma-separated accounts) to the includes list, granting visibility to the entry. Email or Account GUIDs are acceptable.

--includes-remove
:   Removing an account (or list of comma-separated accounts) from the includes list, revoking visibility to the entry. Email or Account GUIDs are acceptable.
  
--excludes-add
:   Adding an account (or list of comma-separated accounts) to the excludes list. Email or Account GUIDs are acceptable.

--excludes-remove
:   Removing an account (or list of comma-separated accounts) from the excludes list, revoking visibility to the entry. If the account was set by global admins, the account admins can't remove the account. Email or Account GUIDs are acceptable.

--owner
:   Changing the owner of an object. Email or Account GUIDs are acceptable.

--restrict
:   Changing the restriction of the visibility object to 'Private'.

--unrestrict
:   Changing the restriction of the visibility object to 'Public'.
  
-c
:   Valid JSON object that contains catalog-specific configuration parameters, provided either inline or in a file. For a list of supported configuration parameters, see the documentation for the particular catalog entry.

--global
:   Operate in global scope

### Examples
{: #ibmcloud_catalog_entry_visibility_set_examples}

Set visibility of resource `j402-dnf1i` from JSON file:
```bash
ibmcloud catalog entry-visibility-set 'j402-dnf1i' -c @visibility.json
```
{: codeblock}

## ibmcloud catalog service-marketplace
{: #ibmcloud_catalog_service_marketplace}

List service offerings in the marketplace:
```bash
ibmcloud catalog service-marketplace [--rc] [--global]
```
{: codeblock}

### Command options
{: #ibmcloud_catalog_service_marketplace_options}

--rc
:   Show RC compatible services only

--global
:   Operate in global scope

### Examples
{: #ibmcloud_catalog_service_marketplace_examples}

Show service offerings in global scope:
```bash
ibmcloud catalog service-marketplace --global
```
{: codeblock}

## ibmcloud catalog service
{: #ibmcloud_catalog_service}

View details of a service in the catalog, including a description, tags, compatibility information, and available plans. 

```bash
ibmcloud catalog service NAME_OR_ID [--global]
```

### Command options
{: #ibmcloud_catalog_service_options}

--global
:   Operate in a global scope

### Examples
{: #ibmcloud_catalog_service_examples}

Show details of the `container-kubernetes` service:
```bash
ibmcloud catalog service container-kubernetes
```
{: codeblock}

## ibmcloud catalog locations
{: #ibmcloud_catalog_locations}

Get a choice subset of regions in your choice of format.
```bash
ibmcloud catalog locations [-i, --id ID] [-k, --kind KIND] [--col COLUMNS] [--global] [--csv]
```
{: codeblock}

### Command options
{: #ibmcloud_catalog_locations_options}

-i, --id
:   Specify geography by id.

-k, --kind
:   Get a list of entries for the specified kind.

--col
:   Specify more columns for the table. Currently, "group", "provider", and "tags".

--global
:   Operate in a global scope.

--csv
:   Output CSV file