Skip to content
Help Center
Submit a request Sign in

Manage reusable knowledge-base files

The File Repository keeps reusable images and documents available to article and template authors. A maintained folder structure helps authors find approved files and avoids unnecessary duplicate uploads.

Applies to: Supportbench Core. Location: Settings → Knowledge Base → File repository. Management requires Administer the file repository. Read-only browse/insert is separate.

Before you begin

  • You need Administer the file repository to manage files or folders. A read-only repository picker can still support browsing/insertion.
  • Find the existing file and its uses before uploading another copy. A same-name upload in the same folder can replace content referenced by existing articles.
  • Reopen the saved result and test a representative consuming workflow. A successful save alone does not verify every reader, assignment or rendered result.

Configure and verify

  1. Open Settings → Knowledge Base → File repository, or the repository picker in a supported editor. Browse or search for the intended folder/file.
  2. To organize new content, use New Folder, enter Folder name and confirm the folder dialog. Verify the new folder location.
  3. Select the intended folder and choose Upload File. Check the name and existing file before proceeding, then inspect the saved file.
  4. Use the permitted Rename/Move/Delete folder or file actions for deliberate maintenance. A folder must be empty before deletion.
  5. Use Open to inspect the item or Insert in the supported editor context. Saving a file in the repository does not insert it into every article.
  6. Save the consuming article through its normal workflow and verify the actual image/link for the intended reader. Recheck existing references after a replacement or move.

Settings reference

Folders and files

SettingWhat it controlsHow to choose
Search / FoldersFinds repository files and their folder location.Use consistent names and a simple folder structure.
New / Rename / Move folderOrganizes folders, including moves to root.Review the destination before moving content.
Delete folderDeletes only an empty folder.Remove or relocate its contents deliberately first.
UploadAdds a file; the same folder/name can replace an existing file.Check for an existing file before uploading a replacement.
Open / InsertOpens the file or inserts its repository reference into the consuming editor.Verify the file and intended audience before inserting it.
Move file / Delete fileMaintains an existing repository item.Review article and template references before either operation.

Behavior to know

  • Repository administration requires the file-repository edit permission and the Knowledge Base module. Browsing/insertion and administration can have different access.
  • Deleting a file can break articles or templates that reference it. Verify links after moving or replacing a file; do not assume every existing reference will be rewritten.

Recommended use

  • Use recognizable filenames and a simple folder structure that another author can maintain.
  • Avoid same-name replacement without reviewing existing references.
  • Check reader access and rendering rather than assuming repository browsing as an agent proves customer access.

Worked example: replace a product diagram without silently changing unrelated instructions

  1. A knowledge author has an approved, sanitized controller-status diagram. In the intended product-image folder, search for controller-status-light-v2.png before upload. The name is illustrative; use a filename that identifies the actual image and its purpose.
  2. If a file already has that name in the same folder, inspect its existing uses before replacing it. A same-name upload can change content referenced by published articles. If the new diagram applies to a different version or task, keep distinct files with clear names instead of replacing the old image.
  3. Use Upload File in the chosen folder and Open to inspect the saved image. Confirm it contains no customer identifiers or credentials. Repository storage alone has not added the image to any article.
  4. Use Insert in a supported article editor, add meaningful alternative text and a caption, and save the article through its normal workflow. The written steps should still explain the task without the picture.
  5. Verify the saved image and its meaning as the intended customer as well as an agent. After a deliberate replacement or move, recheck known references. If one breaks, correct that article’s actual reference rather than repeatedly uploading copies into unrelated folders.

Troubleshooting

ProblemWhat to check
Management actions are unavailableCheck Administer the file repository; read-only browsing and insertion can remain available.
Folder deletion failsRemove or relocate its contents deliberately first; nonempty folders cannot be deleted.
An old article now shows a different fileCheck whether a same-name upload replaced the referenced content.
The file exists but is absent from the articleInsert/link it in the consuming editor and complete that article’s save/publication route.
A customer sees a broken image or linkInspect the saved article reference and the intended reader’s actual access/rendering.
  • Knowledge Base → Configure article templates and AI authoring guidance
  • Knowledge Base → Organize knowledge-base topics and access
  • Organization → Configure agent roles and division access

Was this article helpful?