Create a Topic Hierarchy in Experience Cloud Sites
Create a topic hierarchy in Experience Cloud sites.
Example 1: Create a Hierarchy with Managed Topics
Step 1: Identify or Create the Parent Topic
The parent topic must be a navigational managed topic.
- Resource
- /connect/communities/communityId/managed-topics
- HTTP method
- GET to retrieve a list of navigational managed topics to identify the parent topic.
- POST to create a parent topic. Community managers (users with the Create and Set Up Experiences or Manage Experiences permission) can create managed topics.
- Response body for GET
- Managed Topic Collection
- Make a note of the ID of the navigational managed topic you want to be the parent topic. It has a prefix of 0mt.
- Request body for POST
- Managed Topic Input
- Request body example for POST
-
{ "name":"Parent Topic", "managedTopicType":"Navigational" }
- Response body for POST
- Managed Topic
- Make a note of the ID of the parent topic you created. It has a prefix of 0mt.
Step 2: Create the Child Topic and Link to the Parent in a
Hierarchy
In this step, create a managed child topic and link it to its parent in one step.
- Resource
- /connect/communities/communityId/managed-topics
- HTTP method
- POST
Community managers (users with the Create and Set Up Experiences or Manage Experiences permission) can create managed topics.
- Request body
- Managed Topic Input
- Request body example
- Use the navigational managed topic ID from Step 1 as the parentId.
-
{ "name":"Child Topic", "managedTopicType":"Navigational", "parentId":"0mtR000000001KLIAY" }
- Response body for POST
- Managed Topic
See the Hierarchy
By default, the managed topic response body shows only
the top level of a hierarchy. You can have up to three levels in your topic hierarchy. To see
all the levels, use this resource and these
parameters:
/connect/communities/communityId/managed-topics?depth=3&managedTopicType=Navigational
Example 2: Create a Hierarchy with Managed and Standard Topics
It’s also possible to use a standard topic, instead of a managed topic, to be the child topic, but this requires an additional step.
Step 1: Identify or Create the Parent Topic
The parent topic must be a navigational managed topic.
- Resource
- /connect/communities/communityId/managed-topics
- HTTP method
- GET to retrieve a list of navigational managed topics to identify the parent topic.
- POST to create a parent topic. Community managers (users with the Create and Set Up Experiences or Manage Experiences permission) can create managed topics.
- Response body for GET
- Managed Topic Collection
- Make a note of the ID of the navigational managed topic you want to be the parent topic. It has a prefix of 0mt.
- Request body for POST
- Managed Topic Input
- Request body example for POST
-
{ "name":"Parent Topic", "managedTopicType":"Navigational" }
- Response body for POST
- Managed Topic
- Make a note of the ID of the parent topic you created. It has a prefix of 0mt.
Step 2: Identify or Create the Child Topic
In this example, identify or create a standard topic, instead of a managed topic, to be the child topic.
- Resource
- /connect/communities/communityId/topics
- HTTP method
- GET to retrieve a list of topics to identify the child topic.
- POST to create a child topic. Users with the Create Topics permission can create topics.
- Response body for GET
- Topic Collection
- Make a note of the ID of the topic you want to be the child topic. It has a prefix of 0TO.
- Request body for POST
- Topic Input
- Request body example for POST
-
{ "description":"This topic will be a child topic of Parent Topic.", "name":"Child Topic" }
- Response body for POST
- Topic
- Make a note of the ID of the child topic you created. It has a prefix of 0TO.
Step 3: Link the Child and Parent Topic in a Hierarchy
- Resource
- /connect/communities/communityId/managed-topics
- HTTP method
- POST
- Request body
- Managed Topic Input
- Request body example
- Use the managed topic ID from Example 2, Step 1 as the parentId and the topic ID from Example 2, Step 2 as the recordId.
-
{ "managedTopicType":"Navigational", "parentId":"0mtR000000001KLIAY", "recordId":"0TOD00000000cwk" }
- Response body
- Managed Topic