Importing and Exporting Articles

Article Import & Export

Helpium supports bulk article operations via JSON files, making it easy to migrate content or create backups.

Exporting Articles

1. Go to Knowledge Base → Articles
2. Click the Export button
3. Optionally filter by status, visibility, or category before exporting
4. A JSON file is downloaded containing all matching articles

The export includes each article's title, content, excerpt, category, status, and visibility.

Downloading an Example File

Click Download Example on the import page to get a sample JSON file showing the expected format. This is helpful when preparing articles from an external source.

Importing Articles

1. Go to Knowledge Base → Articles
2. Click the Import button
3. Upload a JSON file with your articles

Each article in the JSON file should include:

• title (required)
• content (required, Markdown format)
• excerpt (optional)
• category (optional, category name, created automatically if it doesn't exist)
• status (optional, defaults to draft)

Import Behavior

• New articles are created if no matching ID exists
• Existing articles can be updated by including an id field
• Duplicate slugs are handled by appending a numeric suffix
• Categories referenced in the import are created automatically if they don't exist
• Articles are validated against your plan's article limit

Import Results

After import, you'll see a summary:

• Imported: New articles created
• Updated: Existing articles updated
• Skipped: Articles that failed validation