Working with Knowledge folders
Find answers to common questions about working with knowledge folders and files in Atlan.
What file formats can I upload?
You can upload PDF and Markdown (.md) files. Support for additional formats is on the roadmap.
What is maximum file size?
Each file can be up to 50 MB.
What happens if I upload file with duplicate name?
The upload is blocked, and the existing file is retained. The upload panel shows the date the original file was uploaded.
Why weren't skills generated for my knowledge file?
Skills are generated for procedural documents such as SOPs, policies, and compliance rules. Descriptive or reference documents are less likely to produce skills. The context agent processing the file also determines the extraction logic. If no skills appear in the file's lineage, the content type may not meet the agent's criteria.
Who can upload or edit knowledge files?
Only Admins and API tokens can create knowledge folders, upload files, or replace existing files. Members and Guests can view and preview knowledge content but can't contribute files.
If your organization needs data stewards or team leads to upload files, a tenant admin can extend permissions by creating custom AuthPolicies for a dedicated persona. See Access control for details.
Can I restrict access to specific folders?
Not currently. Access control uses entity-type wildcards, so permissions apply to all knowledge folders and files on the tenant. A user who can see knowledge assets sees all of them. Folder-level granularity isn't supported yet.
Can I access knowledge files programmatically?
Yes. The Wisdom API supports fetching raw file content:
GET /api/service/knowledge/files/preview?key={filePath}&name={filename}
Authorization: Bearer <YOUR_TOKEN>
Replace {filePath}, {filename}, and <YOUR_TOKEN> with the relevant values for your tenant.
Can I preview knowledge files without downloading them?
Yes. Open the file's profile page in the catalog to preview its contents.
Need help
If you have questions about knowledge folders and files that aren't covered in this FAQ, contact Atlan support by submitting a support request.
See also
- Create knowledge folder and upload files: Step-by-step instructions for uploading documents
- Knowledge folders and files: What knowledge folders and files are as catalog assets