How to Upload a Structured Items List
Step-by-step guide to upload your CSV or JSON data files to Atri AI Search for powerful content search capabilities.
What You'll Need
- A CSV or JSON file with your structured data
- Required fields: id, title, variant_title in your data
- File size under 100MB
- Data saved with UTF-8 encoding
- Access to your AI Search project dashboard
Configuration Steps
Step 1: Prepare Your Data File
Ensure your file contains the required fields and follows the proper structure.
- Create a CSV or JSON file with your data
- Include required fields: id, title, variant_title
- Add any additional fields you want to search (description, category, price, tags, etc.)
- Save the file with UTF-8 encoding
- Keep file size under 100MB
Step 2: Navigate to Data Source Configuration
Access the data source settings in your AI Search project.
- Go to your AI Search project dashboard
- Navigate to the data sources configuration section
- Select 'Upload Data File' as your data source option
- The file upload interface will appear
Step 3: Upload Your File
Use the drag-and-drop interface to upload your data file.
- Drag and drop your CSV or JSON file onto the upload area
- Alternatively, click 'Select File' to browse and choose your file
- Wait for the file to be selected and displayed
- Verify the correct file name appears in the interface
Step 4: Process the Data
Initiate the data processing to analyze your file structure.
- Click 'Upload & Process' to start the upload
- The system will automatically detect field types and structure
- Wait for the processing to complete (typically takes a few minutes)
- A success message will appear when processing is finished
Step 5: Review Detected Fields
Verify that your data fields have been correctly identified.
- Review the list of fields detected from your data
- Fields are categorized as text, numeric, categorical, boolean, or other
- All detected fields will be available for search configuration
- Note the total number of records processed
- Proceed to the search configuration section
Important Notes
- Ensure all records have unique IDs to prevent data conflicts
- Use consistent field names and data types throughout your file
- Files do not auto-update - you must manually re-upload when data changes
- Processing time depends on file size and number of records
- Keep backups of your original files for reference and updates
Common Issues
File upload fails with 'Invalid format' error
- Ensure your file is in CSV or JSON format
- Check that required fields (id, title, variant_title) are present
- Verify file structure matches the documented examples
- Try uploading a smaller test file first
Special characters not displaying correctly
- Save your file with UTF-8 encoding
- Use a text editor that supports UTF-8 encoding
- Check that international characters are properly formatted
- Avoid special characters in field names
Processing takes too long
- Large files may take several minutes to process
- Check your internet connection stability
- Ensure file size is under 100MB
- Contact support if processing exceeds 30 minutes
Fields not detected properly
- Verify your file has headers in the first row (CSV)
- Check that JSON files contain an array of objects
- Ensure consistent field names across all records
- Remove any empty columns or fields