Models Bulk Import
What This Page Does
This page lets you add multiple model profiles to your site at once by pasting or uploading data from a spreadsheet or CSV file. Instead of manually creating each model profile one by one, you can import dozens or hundreds of models in a single operation. The system automatically downloads profile images, checks for duplicates, and shows you real-time progress as the import runs.
[Screenshot: page-overview]
How to Get Here
Navigate to Admin Panel > Models > Bulk Import
Understanding the Page
When you first open this page, you'll see several sections stacked vertically. At the top is the playlist section for saving and loading your import settings. Below that is the field mapping area where you tell the system which column in your data corresponds to which model information (name, gender, age, etc.). At the bottom is where you paste your actual model data.
Playlist Section
This section lets you save your column configurations so you don't have to set them up every time. If you regularly import models from the same source (like a modeling agency database), you can save the setup once and reload it with one click next time.
Field Mapping Section
Here you configure how your data columns match up with the model information in the system. For example, if your first column is the model's name, you'll select "Model Name" from the dropdown. If the second column is their age, you'll select "Age" from that dropdown, and so on. You can add or remove columns using the + and - buttons.
Data Input Section
This is where you paste your actual model data or provide a path to a CSV file on your server. Each line represents one model, with values separated by commas (or whatever delimiter you're using).
Common Tasks
How to Import Models from a Spreadsheet
When you have model data in Excel, Google Sheets, or another spreadsheet program.
- Open your spreadsheet and select all the model data you want to import (not including header rows).
- Copy the data to your clipboard.
- In the admin panel, navigate to Admin Panel > Models > Bulk Import.
- Configure the field mappings to match your data columns:
- For Column 1, select what type of information is in the first column of your data (usually "Model Name").
- For Column 2, select what's in your second column (like "Gender" or "Age").
- Continue for all columns. Use the + button if you need more columns than shown.
- Paste your copied data into the Model Data text box.
- Make sure the Delimiter field shows a comma (or change it to match your data separator).
- Click Preview Import.
- Review the preview table to make sure everything looks correct.
- Click Confirm & Start Import.
- Watch the progress bar and log messages as the import runs.
[Screenshot: basic-import-example]
How to Import Models with Profile Pictures
When your data includes web addresses (URLs) for model profile images.
- Set up your field mappings as usual, making sure one column is mapped to Image URL.
- Paste your data. Each row should include a full web address to the model's image (like
https://example.com/models/jane.jpg). - Click Preview Import and verify the URLs appear in the preview table.
- Click Confirm & Start Import.
- Watch the "Images Downloaded" counter as the system automatically downloads each image and saves it to your site.
The system supports JPG, PNG, GIF, and WebP image formats. Images are saved to your site automatically and linked to each model's profile.
How to Save and Reuse Import Settings
When you import from the same data source regularly.
- Set up all your field mappings the way you need them.
- Type a name for this configuration in the Playlist Name field (like "Agency Database Export" or "CamSite Models").
- Click Save.
- You'll see a green success message confirming the save.
Next time you need to import from the same source:
- Open the Load Existing Playlist dropdown at the top of the page.
- Select your saved playlist name.
- The field mappings load instantly.
- Just paste your new data and click Preview Import.
How to Delete a Saved Playlist
When you no longer need a saved configuration.
- Select the playlist from the Load Existing Playlist dropdown.
- Click the Delete button next to the playlist dropdown.
- Confirm the deletion in the popup that appears.
How to Import from a CSV File on Your Server
When your CSV file is already uploaded to your web server (via FTP or another method).
- Upload your CSV file to your server using FTP or your hosting control panel.
- Note the full server path to the file (like
/home/username/imports/models.csv). - Set up your field mappings as usual.
- Instead of pasting data in the text box, enter the full file path in the CSV File Path field.
- Click Preview Import.
- The system reads the file and shows you the preview.
- Click Confirm & Start Import to proceed.
Field Mapping Options
When setting up your import, you need to tell the system what each column in your data represents. Here are all the available options and what they mean:
Understanding the Import Process
Preview Step
When you click Preview Import, the system:
- Checks your field mappings for errors
- Parses your data based on the delimiter you specified
- Shows you a preview table with the first few rows
- Saves everything temporarily so the actual import can run
Review this preview carefully. This is your chance to catch mistakes before the data goes into your database.
Import Step
When you click Confirm & Start Import, you'll see a new screen with:
Progress Bar - A green bar showing what percentage of the import is complete
Status Line - Shows "Processed X of Y" so you know how many models have been handled
Log Panel - A scrolling message area showing each model as it's added, any errors, and duplicate detections
Statistics Cards - Three boxes showing:
- Models Added - How many new model profiles were created
- Images Downloaded - How many profile pictures were successfully downloaded
- Images Failed - How many image downloads didn't work (if any)
The import runs in the background, so even if you accidentally close the browser tab, it keeps going. However, you won't be able to see the progress if you navigate away.
[Screenshot: progress-screen]
After Import Completes
When the import finishes, you'll see three buttons:
- View Models - Go to the Models page to see all your imported profiles
- Admin Home - Return to the main admin dashboard
- New Import - Start another import
Filters and Search
This page doesn't have filters or search features. It's designed for bulk import operations only. To search and filter models after importing, use the Admin Panel > Models page.
Tips for New Users
- Start small: Import 5-10 test models first to make sure your field mappings are correct
- Save playlists: If you import from the same data source more than once, save your configuration as a playlist
- Check delimiter: Most spreadsheets use commas, but some use tabs or semicolons. Make sure the delimiter matches your data
- Model names are unique: If you try to import a model that already exists (exact name match), it will be skipped
- Images take time: Each image download can take up to 45 seconds. For large imports, consider importing basic data first and adding images later
Troubleshooting
The preview table looks wrong or scrambled
What you see: Columns are in the wrong places or data looks mixed up in the preview.
How to fix it:
- Check your delimiter setting. If your data is separated by tabs instead of commas, change the delimiter to
{tab}(type that exactly - it converts to a tab character automatically). - Make sure your field mappings match the order of columns in your data.
- Check that your data doesn't have extra commas inside the text (like "Smith, Jane" instead of "Jane Smith").
Models aren't showing up on my site after import
What you see: The import says it completed successfully, but you don't see the models on your public site.
How to fix it:
- Go to Admin Panel > Models and check if the models are there.
- Look at the Status column. Only models with status "Active" appear on the public site.
- If they show "Pending" or "Inactive," you need to edit each model and change the status to "Active."
Some models were skipped during import
What you see: The log panel shows "Duplicate model name: [Name]" messages.
How to fix it:
- This means a model with that exact name already exists in your database.
- If you want to add them anyway, give them a slightly different name in your data (like "Jane Doe 2").
- Or, if they're truly duplicates, you can ignore the skipped entries.
Profile images didn't download
What you see: "Images Failed" counter is high or all image downloads failed.
How to fix it:
- Check that the image URLs in your data are complete and start with
http://orhttps://. - Try opening one of the URLs in your browser to verify the images are accessible.
- Some images might be behind login walls or have access restrictions - those can't be downloaded automatically.
- Check that your server has permission to write to the images folder (the system creates this automatically, but some servers have strict permissions).
The import is taking a very long time
What you see: Progress bar is moving very slowly or appears stuck.
How to fix it:
- If you're importing images, this is normal. Each image can take time to download.
- Wait it out - the import will complete. The log panel will continue showing activity.
- For future imports, consider importing data without images first, then add images separately.
I closed the browser tab during import
What you see: You accidentally closed or refreshed the page while the import was running.
What happens:
The import continues running on the server even though you closed the tab. However, you can't get back to the progress screen for that specific import.
How to check:
- Go to Admin Panel > Models and see if the count of models increased.
- The import will finish eventually (check back in 5-10 minutes for large imports).
- There's no way to cancel an import once it starts, so let it finish.