Body
Who can use this feature?
- License Requirement: Any license type (permissions matter more than license)
- Application Access: User must have access to the specific Client Portal application containing the Knowledge Base
- Application-level Security Role: User must have an Administrator Security Role in the specific Client Portal
- Administrative Access:
- Global Administrators can import articles for any Client Portal application in TDAdmin
- Client Portal Application Administrators can import articles for their specific Client Portal application in the Client Portal Admin
TeamDynamix provides a bulk import feature for adding multiple Knowledge Base articles simultaneously through TDAdmin. The process is designed to streamline the migration of existing content into the platform's searchable knowledge base system.
In this article, we'll cover:
Before you start preparing your articles for import, here are some things to keep in mind about how the article importer works:
- Only one ZIP file can be processed per import session
- All articles in an import batch are assigned to the same category
- Multiple imports are required if articles need different categorizations
- Images are supported through subfolders in the ZIP package
File Requirements:
- Only HTML files and images can be imported
- Each article that includes images must have its own folder, and the folder name must follow the format:
- articlefilename_files
- For example, if the article file name is 'getting_help.html,' the corresponding folder must be named 'getting_help_files'
- Content must be packaged in a ZIP file. Formats such as 7Z, TAR, RAR, or others will not be accepted
- The ZIP file should not contain a parent folder with all the HTML files and folders beneath it
- ZIP file size cannot exceed 100 MB. Larger imports may need to be broken into multiple ZIPs
- Word documents must be converted to HTML
- HTML must be valid; files with invalid HTML will be omitted from the import
To prepare your ZIP file:
- Place all your HTML files in a single folder, along with a subfolder for any images you need.
- Select each article and image folder to include in the ZIP. Don't include the parent folder that contains them all.
- Compress the files into a ZIP file.

- Open the Article Import page:
- Client Portal Admins: In the Client Portal, click your name in the top right > Admin > Knowledge Base > Article Import
- Global Admins: In TDAdmin, navigate to Applications > [Client Portal Name] > Knowledge Base > Article Import
- Use the Browse button to select the ZIP file to import. Note that only one ZIP file can be imported at a time.
- Choose the Category or sub-category of the Knowledge Base where all articles in the ZIP folder will be added.
- Optionally, modify the Order in which the articles will appear.
- Optionally, enter Tags to add to all of the imported articles.
- Set the Status for the imported articles (options visible vary based on user permissions):
- Not submitted if the articles will need editing after import
- Submitted if the imported articles are ready for review as is
- Approved if the imported articles are ready to go live
- Rejected will import the articles, but the status will indicate they are not to be used until issues are resolved
- (Optional) Check the Published to KB box to publish the articles, allowing anyone to view them.
- Select an Owner for the articles.
- (Optional) Check the box to Notify Owner on Feedback.
- At the top of the page, click Import.
If your content is currently in Microsoft Word, you can convert .docx or .doc files to HTML from Word. This will also save document images to a separate folder.
- In Microsoft Word, click the File menu
- Select Export, then Change File Type
- In the file type list, select Save as Another File Type, then click Save As
- In the popup, in the Save as type dropdown, select Web Page, Filtered
- At the bottom of the popup, click Tools and select Web Options
- Check the Allow PNG as a graphics format box
- Click OK and then Save to begin the export process
To convert multiple .docx or .doc files simultaneously, you could use a batch converter, such as the Batchwork Word to HTML converter. Search the web for more tools with a search phrase such as "convert .docx or .doc to HTML."