Definition
Import Articles is a Setup feature for bulk-importing Knowledge articles into Salesforce from CSV files. It allows administrators to migrate existing knowledge content from external systems, including article titles, bodies, data categories, and metadata, into the Salesforce Knowledge base.
Real-World Example
The admin at BrightStar Telecom uses Import Articles to migrate 2,000 support articles from their legacy wiki system. She formats the content into a CSV file with columns for Title, Body (HTML), Product Category, and Language, uploads it through the import tool, and assigns each article to the appropriate data category and publish status.
Why Import Articles Matters
Import Articles is a Salesforce Knowledge administration feature that enables bulk importing of articles from external sources using CSV files. When organizations migrate from legacy knowledge bases, wikis, or help desk systems to Salesforce Knowledge, Import Articles provides a structured way to bring existing content into the platform without manually recreating each article. The CSV file maps columns to article fields including Title, Body (supporting HTML content), URL Name, Data Categories, and metadata like Language and Publish Status. This tool is essential for knowledge migration projects where organizations need to preserve years of accumulated support content and make it available to agents and customers through the Salesforce Knowledge base.
As knowledge bases grow and organizations consolidate multiple content repositories, Import Articles becomes critical for efficient migration without content loss. A typical migration from a legacy system involves thousands of articles that would take months to recreate manually. Import Articles handles the heavy lifting but requires careful preparation: content must be properly formatted in the CSV, HTML must be clean and compatible with Salesforce's rich text editor, and data categories must exist in the org before import. Organizations that rush the import without proper data preparation often end up with broken formatting, missing images, and incorrectly categorized articles. Best practice includes running a small test batch of 20-50 articles first, validating the output, fixing any issues in the CSV template, and then running the full import.
How Organizations Use Import Articles
- BrightStar Telecom — BrightStar Telecom migrated 2,000 support articles from their legacy Confluence wiki using Import Articles. They formatted content into a CSV with columns for Title, Body (HTML), Product Category, and Language. The import tool processed all articles in 3 hours, assigning each to the correct data category and setting initial publish status to 'Draft' for review before going live.
- GlobalServe IT — GlobalServe IT consolidated knowledge from 3 acquired companies into a single Salesforce Knowledge base. They exported articles from each company's system into standardized CSVs and used Import Articles to load them in batches of 500. The phased approach allowed the knowledge management team to review each batch for quality before importing the next.
- CareConnect Health — CareConnect Health imported 5,000 clinical reference articles from their medical database into Salesforce Knowledge. The articles included HTML-formatted procedures with embedded tables and step-by-step instructions. They used a test batch of 30 articles to identify and fix HTML formatting issues before running the full import, saving weeks of post-import cleanup.