Skip to main content
More in Learn

Search by Topics

Topic Maps are a powerful tag mechanism in Crystallize. They allow multi-dimensional linking of any of the custom shapes, including products, documents, or folders. This section details how you can search items belonging to a topic map using the Search API.

In order to perform these operations, ensure that you have the proper authentication (if necessary) and user permissions.

Filter by Topics

When we filter by topics, we do so by using a topic’s path. This allows us to filter specifically by a topic belonging to a specific topic map, even if there’s another topic with the same name in a different map.

The topicPaths filter provides a simple way to filter on one or more topics, with a logical structure that allows you to query more concise results.

For example, let’s say we want to fetch all living room tables that are of the color black or white. We can build up a logical topicPaths query, along with some other filters.

In case you want to also include children topics, simply place the wildcard symbol at the end of your path, such as:


Example Query:

People showing thumbs up

Need further assistance?

Ask the Crystallize team or other enthusiasts in our slack community.

Join our slack community