{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Folder Import","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":"folder-import","__idx":0},"children":["Folder Import"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"about-folders","__idx":1},"children":["About Folders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Folders organize knowledge articles efficiently, making them easily accessible to Knowledge Console users. They categorize articles based on common parameters such as content type and target audience."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a new department is created, several standard folders are automatically generated in the Knowledge Console. Authors with the appropriate permissions can create custom folders to better manage content. These user-created folders have configurable permissions, allowing other authors to view, create, edit, or delete articles and subfolders within them."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"organizing-folder-structure","__idx":2},"children":["Organizing Folder Structure"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organize Folders Sequentially"]},": Arrange folders in a sequential order to ensure a clear and intuitive structure."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Subfolders as Needed"]},": Within each folder, create multiple subfolders to further organize the content. Ensure that subfolders follow the same logical sequence."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example Structure in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["knowledgehub.json"]},":"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"folders\": [\n    {\n        \"name\": \"Catalogs\",\n        \"description\": \"\"\n    },\n    {\n        \"name\": \"Credit Cards / Payments\",\n        \"description\": \"\"\n    },\n    {\n        \"name\": \"Macros\",\n        \"description\": \"\",\n        \"folders\": [\n            {\n                \"name\": \"Company Information\",\n                \"description\": \"\"\n            },\n            {\n                \"name\": \"Contact Information\",\n                \"description\": \"\"\n            }\n        ]\n    }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creating-folders","__idx":3},"children":["Creating Folders"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Access the Knowledge System:"]}," Log into the Knowledge Console."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Review the Folder Hierarchy:"]}," Note the existing folder structure to understand how new folders will fit."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Set Up the Folder Array:"]}," In knowledgehub.json, map the folder structure. Begin with a root element named \"folders\" that contains an array."]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n    \"folders\": []\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Each Folder:"]}," Add an object within the \"folders\" array for each top-level folder."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name of the folder"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Description"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Description of the folder"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"folders\": [\n    {\n        \"name\": \"Name of folder\",\n        \"description\": \"Description of folder\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Repeat for Additional Folders:"]}," Continue adding folder objects to the \"folders\" array."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creating-subfolders","__idx":4},"children":["Creating Subfolders"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Locate the parent folder:"]}," In your JSON structure, find the parent folder object where you want to add a subfolder."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Set Up the Subfolder Array:"]}," Add a \"folders\" array within the parent folder object."]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n    \"folders\": [\n    {\n        \"name\": \"Name of folder\",\n        \"description\": \"Description of folder\",\n        \"folders\": []\n    }\n    ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Each Subfolder:"]}," Add a folder object within the nested \"folders\" array for each subfolder."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name of the folder"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Description"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Description of the folder"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"folders\": [\n    {\n        \"name\": \"Name of folder\",\n        \"description\": \"Description of folder\",\n        \"folders\": [\n          {\n            \"name\": \"Name of subfolder\",\n            \"description\": \"Description of subfolder\"\n          }\n        ]\n    }\n  ]\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Folder Import","id":"folder-import","depth":1},{"value":"About Folders","id":"about-folders","depth":2},{"value":"Organizing Folder Structure","id":"organizing-folder-structure","depth":2},{"value":"Creating Folders","id":"creating-folders","depth":3},{"value":"Creating Subfolders","id":"creating-subfolders","depth":3}],"frontmatter":{"seo":{"title":"Folder Import"}},"lastModified":"2026-03-23T19:46:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developer-portal/guides/ingestion/folder-import-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}