Skip to main content

​
Overview

Mapademics offers three different ways to import your data. This guide helps you identify which import mode you’re using and directs you to the appropriate troubleshooting resources.
If you’re experiencing import issues, start by identifying which import mode you’re using, then refer to the mode-specific troubleshooting section in that guide.

​
Which Import Mode Are You Using?

Full Import

Excel template-based importYou’re using Full Import if you:
  • Downloaded an Excel template
  • Filled out multiple sheets (Programs, Courses, etc.)
  • Are importing many items at once

Course Import

URL-based course importYou’re using Course Import if you:
  • Pasted syllabus URLs
  • AI extracted course information
  • Are importing courses one-by-one or in batches

Job Import

URL-based job importYou’re using Job Import if you:
  • Pasted job posting URLs
  • AI extracted job details
  • Are importing jobs one-by-one or in batches

​
Common Issues Across All Import Modes

​
Skills Extraction Not Working

If skills extraction isn’t working after a successful import:
  1. Check Background Jobs: Navigate to Background Jobs to monitor processing status
  2. Verify file accessibility: Ensure PDFs are publicly accessible without login
  3. File format: PDFs work best for skills extraction
  4. Wait for processing: Large files may take 10-30 minutes to process
Skills extraction runs in the background after import completes. You can continue working while it processes.

​
Slow Processing or Timeouts

Symptoms: Import appears to hang or shows timeout errors Solutions:
  • For Full Import: Split large datasets into smaller batches (see Full Import Troubleshooting)
  • For Course Import: Import fewer URLs at once (try 5-10 at a time)
  • For Job Import: Import fewer URLs at once (try 5-10 at a time)
  • General: Import during off-peak hours for better performance

​
Data Doesn’t Appear After Import

If your import completed but data isn’t showing:
  1. Refresh the page: Browser cache may be showing old data
  2. Check Import History (Full Import only): Verify what was actually imported
  3. Check for errors: Review any error messages that appeared during import
  4. Verify filters: Ensure you’re not filtering out newly imported data

​
Connection Issues

Symptoms: “Connecting…” message persists or real-time updates not working Solutions:
  • Refresh the browser page
  • Disable VPN or proxy that might block connections
  • Try a different browser (Chrome or Firefox recommended)
  • Check your internet connection stability
Real-time updates enhance the import experience but aren’t required. Your import will complete successfully even if real-time updates aren’t working.

​
Mode-Specific Troubleshooting

For detailed troubleshooting specific to your import mode, please refer to the troubleshooting section in the appropriate guide:

​
Full Import Issues

Common problems:
  • Template validation errors
  • Conflict resolution decisions
  • Cross-reference failures
  • File format issues
View Full Import Troubleshooting →

​
Course Import Issues

Common problems:
  • URL not accessible
  • AI extraction incomplete
  • Duplicate course detection
  • Missing required fields
View Course Import Troubleshooting →

​
Job Import Issues

Common problems:
  • URL not accessible
  • AI extraction incomplete
  • Location not recognized
  • SOC code issues
View Job Import Troubleshooting →

​
Data Quality Best Practices

Regardless of which import mode you use, following these practices will help ensure successful imports:

​
Before You Import

Pre-Import Checklist☑️ Test with small dataset first - Try 5-10 items before bulk importing ☑️ Verify data format - Ensure URLs are accessible or Excel sheets are properly formatted ☑️ Check for duplicates - Review existing data to avoid conflicts ☑️ Stable internet connection - Use wired connection if possible ☑️ Browser compatibility - Use latest Chrome or Firefox

​
During Import

  • Monitor progress: Watch for error messages or warnings
  • Don’t close browser: Keep the import page open until completion
  • Note any warnings: Screenshot or write down any messages
  • Review extracted data: For URL-based imports, verify AI-extracted information

​
After Import

  • Verify data: Check that imported items appear correctly
  • Monitor background jobs: For skills extraction, check processing status
  • Review relationships: Ensure courses link to correct programs, jobs link to employers, etc.
  • Clean up errors: Address any failed items promptly

​
Getting Additional Help

​
When to Contact Support

Contact support if you encounter:
  • Persistent errors after following troubleshooting steps
  • Data loss or corruption
  • System errors not covered in the guides
  • Import succeeds but data is missing
  • Repeated failures with small datasets

​
Before Contacting Support

Please gather this information:
  1. Which import mode you’re using (Full, Course, or Job)
  2. What you were trying to do (step-by-step)
  3. When the error occurred (date and time)
  4. Error messages (exact text or screenshots)
  5. What you’ve tried (troubleshooting steps from this guide)
  6. Sample data (if applicable and no sensitive information)
For Full Import issues, check the Import History page for detailed error logs before contacting support.