IBM Cloud Docs
Collections

Collections

Collections are a way to group feature flags and properties. These collections can be consumed in your apps with the help of a collection ID and App Configuration SDKs. Every feature must be in a collection, so create your collection first.

By default, Collections displays the list of collections in the current App Configuration service instance along with Name, the Labels associated, the date of creation of the collection, and the collection Content (number of feature flags and number of properties).

Create a collection

To create a collection, complete these steps:

  1. From the App Configuration console, click Collections from the navigation menu or from Getting Started > Create a collection.

    List of collections
    Figure 1. List of collections in the current App Configuration service instance.

  2. Click Create. The side panel opens with fields for creating a new collection.

    Create a collection
    Figure 2. App Configuration service creating a new collection

  3. Provide the collection details:

    • Name - name of the collection.
    • Collection ID - the collection identifier, the value is auto suggested based on the entered collection name. You can modify the same, if needed. Use the Collection ID value as the identifier in your SDK or API code.
    • Tags - specify the tags that need to be associated with the collection, which is optional.
    • Description - add a description of the collection, which is optional.

  4. Click Create.

Collection - overflow menu

The overflow menu for each of the collection (three vertical dots) consists of Edit, View features, and Delete operations.

Overflow menu for a collection
Figure 3. Overflow menu for a collection

  • When Edit option is selected, you can change the values for Name, Tags, and Description fields.
  • When Delete option is selected, a confirmation window is displayed to seek confirmation to delete the selected collection. Delete option permanently deletes the collection, this action cannot be undone.

To copy the Collection ID to the clipboard, expand the collection name by clicking collapse arrow next to the required Collection ID and click the Copy to clipboard icon. Use this value as the identifier in your SDK or API code.