Bulk Content Upload (CSV)

Uploading bulk content through CSV is an efficient method for users who wish to import a large number of content items into the ai12z platform at once.
This feature is designed for cases where the content already exists — in plain text or HTML — and you want to upload it directly without crawling external websites.

---

CSV Format for Bulk Content Upload

To use Bulk Content Upload, your CSV file must have the following structure:

content,title,description,url,tags,imageLinks
"<h1>Title 1</h1><p>First content, with commas, safely wrapped in quotes.</p>","First Title","Short description","https://example.com/item1","[\"blog\",\"tech\"]","[\"https://example.com/image1.jpg\"]"
"<h1>Title 2</h1><p>Second content entry.</p>","Second Title","Another description","https://example.com/item2","[\"news\"]","[\"https://example.com/image2.jpg\",\"https://example.com/image3.jpg\"]"

---

Required and Optional Fields

Field	Required?	Description
content	✅ Yes	Main content body, plain text or HTML.
title	Optional	Title for the content item.
description	Optional	Short one-sentence description.
url	✅ Yes	A URL associated with the content.
tags	Optional	JSON array of tags for filtering and search. Example: ["blog", "tech"]
imageLinks	Optional	JSON array of image URLs. Example: ["https://example.com/image1.jpg"]

Note: The tags and imageLinks fields must be valid JSON arrays.

---

Special Formatting Rules for CSV

To ensure your file uploads correctly, follow these important rules:

Case	Action Needed
Field contains a comma ,	Wrap the entire field in double quotes ("...")
Field contains line breaks \\n	Wrap in double quotes
Field contains double quotes \"	Escape by doubling them (\"\")

Example

content,title
"<p>This is a paragraph, with a comma inside.</p>","My Title"
"<p>He said, \"\"Welcome!\"\" to the platform.</p>","Quote Example"

✅ Proper quoting ensures your content is treated as a single field, not accidentally split.

---

Uploading Process

1. Prepare Your CSV File:
   Structure your file with the correct headers and ensure special characters are properly quoted.

2. Access the Upload Interface:
   Navigate to the ai12z platform and select your .csv file under File Upload.

3. Upload and Verify:
   The platform will validate the file and process your content items.

4. Confirmation:
   Once complete, you will receive a success message. Your content will be visible in your project.

---

Best Practices

• Save your CSV file as UTF-8 encoded to prevent special character issues.
• Always wrap fields containing commas or line breaks in double quotes.
• Use valid JSON formatting for tags and imageLinks.
• Keep each content item under 500,000 characters to avoid ingestion size limits.
• If unsure, test uploading a small sample file first before doing large batches.

---

By following these guidelines, you can efficiently upload high volumes of content to the ai12z platform using the Bulk Content Upload CSV feature.