{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Integrating Folder, Topic, and Portal Structures into knowledgehub.json","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrating-folder-topic-and-portal-structures-into-knowledgehubjson","__idx":0},"children":["Integrating Folder, Topic, and Portal Structures into knowledgehub.json"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To streamline the data import process, previously created folder, topic, and portal structures should be combined into a single ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["knowledgehub.json"]}," file. This comprehensive file encapsulates all the necessary elements of the knowledge base, making it easier to manage and import into the eGain system."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"components-of-knowledgehubjson","__idx":1},"children":["Components of knowledgehub.json"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Folders"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Organize knowledge articles in a hierarchical structure."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Define the folder paths where articles will be stored."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Topics"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Group related articles for easy navigation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Define the topics and assign articles to them."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Portals"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Specify the portals through which the knowledge content will be accessed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Assign topics to the relevant portals."]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-structure","__idx":2},"children":["Example Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following is an example of how the combined ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["knowledgehub.json"]}," file might look:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\n{\n  \"knowledge\": {\n    \"folders\": [\n      {\n        \"name\": \"Purple Nile Retail - Sample Data\",\n        \"description\": \"\",\n        \"folders\": [\n          {\n            \"name\": \"Credit Cards & Payments\",\n            \"description\": \"\"\n          }\n        ]\n      }\n    ],\n    \"topics\": [\n      {\n        \"name\": \"Credit Card and Payments\",\n        \"description\": \"\",\n        \"addArticles\": {\n          \"fromArticles\": [\n            {\n              \"path\": \"Purple Nile Retail - Sample Data/Credit Cards & Payments/E-Gift Cards\"\n            },\n            {\n              \"path\": \"Purple Nile Retail - Sample Data/Credit Cards & Payments/Online Payments\"\n            }\n          ]\n        }\n      },\n      {\n        \"name\": \"Account Management\",\n        \"description\": \"\",\n        \"addArticles\": {\n          \"fromArticles\": [\n            {\n              \"path\": \"Purple Nile Retail - Sample Data/Account Management/Profile Settings\"\n            }\n          ]\n        }\n      }\n    ],\n    \"portals\": [\n      {\n        \"name\": \"Customer Portal\",\n        \"description\": \"\",\n        \"addTopics\": {\n          \"fromTopics\": [\n            {\n              \"path\": \"Credit Card and Payments\"\n            },\n            {\n              \"path\": \"Account Management\"\n            }\n          ],\n          \"fromFolders\": [\n            {\n              \"path\": \"Purple Nile Retail - Sample Data/Credit Cards & Payments\"\n            }\n          ]\n        }\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"creating-the-knowledgehubjson","__idx":3},"children":["Creating the knowledgehub.json"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Combine All Components"]},": Merge the previously created folders, topics, and portals into a single JSON object under the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"knowledge\""]}," key. Ensure the structure is well-formatted and each component is correctly nested."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save the File"]},": Save the combined structure as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["knowledgehub.json"]},"."]}]}]}]},"headings":[{"value":"Integrating Folder, Topic, and Portal Structures into knowledgehub.json","id":"integrating-folder-topic-and-portal-structures-into-knowledgehubjson","depth":1},{"value":"Components of knowledgehub.json","id":"components-of-knowledgehubjson","depth":2},{"value":"Example Structure","id":"example-structure","depth":2},{"value":"Creating the knowledgehub.json","id":"creating-the-knowledgehubjson","depth":2}],"frontmatter":{"seo":{"title":"Integrating Folder, Topic, and Portal Structures into knowledgehub.json"}},"lastModified":"2026-03-23T19:46:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developer-portal/guides/ingestion/knowledge-import-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}