Stay organized with collections
Save and categorize content based on your preferences.
This page
applies to Apigee and Apigee hybrid.
Overview
The entities you create in API hub, such as API resources, versions, and deployments, can have
system and user-defined attributes associated with them. It's a good practice to start off your API hub journey by setting up
and editing key attributes
that align with your
organizational needs and standards. When you register APIs, create versions, and perform other
actions, you can apply attributes and values to build metadata-rich, searchable entities.
Before you begin
API hub must be provisioned in a Google Cloud project to which you have access.
See Provision API hub.
In the Google Cloud console, on the project selector page, select the project in which API
hub is provisioned.
System attributes are predefined by API hub for each resource type. While the attributes
themselves are predefined, you can edit their default values. To learn more, see System attributes.
In the Google Cloud console, go to the Settings page in API hub.
In the System attributes section, click the Edit icon in the Lifecycle row.
In the Allowed values section, click Add item.
In the Value field, enter a value for the attribute, such as "Production", and add a description in the Description field.
Click Save.
Create user defined attributes
User defined attributes are name/value pairs defined by you based on your requirements. To
learn more, see User attributes.
In the User Defined Attributes section of the Settings page, click Create attribute.
In the Add a new attribute form, edit the Allowed values as follows:
Field
Value
Name
Enter a name for the attribute. For example: Latency
Description
Enter a brief description of the attribute.
Maximum allowed values
Specify the number of elements the attribute can hold. An element can have a minimum of one attribute, and a maximum of 20.
Resource type
Select the type of API hub resource to which the attribute can be
associated. Valid choices are: Version, Spec, Operation, Deployment, and Dependency.
Data type
Choose the data type for the attribute. Data types include String, Enum, and JSON. If the Enum data type is selected, click + Add item, and enter the allowed values for the attribute.
Click Create.
Add more user-defined attributes before continuing to the next quickstart, if you wish.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis guide covers managing system and user-defined attributes within API hub for Apigee and Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eSystem attributes are predefined by API hub, but their default values can be edited to align with organizational standards.\u003c/p\u003e\n"],["\u003cp\u003eUser-defined attributes are custom name/value pairs that you create to add metadata to API hub resources, allowing for enhanced searchability.\u003c/p\u003e\n"],["\u003cp\u003eCreating user-defined attributes involves specifying a name, description, maximum allowed values, associated resource type, and data type, with options like String, Enum, and JSON.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, ensure API hub is provisioned in a Google Cloud project and you have selected the correct project in the Google Cloud console.\u003c/p\u003e\n"]]],[],null,["# Create and edit attributes\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\nOverview\n--------\n\nThe entities you create in API hub, such as API resources, versions, and deployments, can have\nsystem and user-defined attributes associated with them. It's a good practice to start off your API hub journey by setting up\nand editing key attributes\nthat align with your\norganizational needs and standards. When you register APIs, create versions, and perform other\nactions, you can apply attributes and values to build metadata-rich, searchable entities.\n\nBefore you begin\n----------------\n\n1. API hub must be provisioned in a Google Cloud project to which you have access. See [Provision API hub](/apigee/docs/apihub/provision).\n2. In the Google Cloud console, on the project selector page, select the project in which API\n hub is provisioned.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n\nEdit system attributes\n----------------------\n\nSystem attributes are predefined by API hub for each resource type. While the attributes\nthemselves are predefined, you can edit their default values. To learn more, see [System attributes](./manage-attributes#system-attributes).\n\n1. In the Google Cloud console, go to the **Settings** page in **API hub**.\n\n [Go to API hub](https://console.cloud.google.com/apigee/api-hub/settings)\n2. In the **System attributes** section, click the Edit icon in the **Lifecycle** row.\n3. In the **Allowed values** section, click **Add item**.\n4. In the **Value** field, enter a value for the attribute, such as \"Production\", and add a description in the **Description** field.\n5. Click **Save**.\n\nCreate user defined attributes\n------------------------------\n\nUser defined attributes are name/value pairs defined by you based on your requirements. To\nlearn more, see [User attributes](./manage-attributes#user-attributes).\n\n1. In the **User Defined Attributes** section of the **Settings** page, click **Create attribute**.\n2. In the **Add a new attribute** form, edit the Allowed values as follows:\n\n3. Click **Create**.\n\nAdd more user-defined attributes before continuing to the next quickstart, if you wish.\n\nNext step\n---------\n\n[Create an Eventarc trigger](./quickstart-create-event-triggers)"]]
