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