ComusThumbz Documentation
Admin Login

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.

  1. Open your spreadsheet and select all the model data you want to import (not including header rows).
  2. Copy the data to your clipboard.
  3. In the admin panel, navigate to Admin Panel > Models > Bulk Import.
  4. 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.
  1. Paste your copied data into the Model Data text box.
  2. Make sure the Delimiter field shows a comma (or change it to match your data separator).
  3. Click Preview Import.
  4. Review the preview table to make sure everything looks correct.
  5. Click Confirm & Start Import.
  6. Watch the progress bar and log messages as the import runs.

[Screenshot: basic-import-example]

Tip: Always start with a small test of 5-10 models to verify your field mappings are correct before importing hundreds of records.

How to Import Models with Profile Pictures

When your data includes web addresses (URLs) for model profile images.

  1. Set up your field mappings as usual, making sure one column is mapped to Image URL.
  2. Paste your data. Each row should include a full web address to the model's image (like https://example.com/models/jane.jpg).
  3. Click Preview Import and verify the URLs appear in the preview table.
  4. Click Confirm & Start Import.
  5. 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.

Warning: Downloading images takes extra time. If you're importing many models (100+), the import might take several minutes. The progress bar will keep you updated.

How to Save and Reuse Import Settings

When you import from the same data source regularly.

  1. Set up all your field mappings the way you need them.
  2. Type a name for this configuration in the Playlist Name field (like "Agency Database Export" or "CamSite Models").
  3. Click Save.
  4. You'll see a green success message confirming the save.

Next time you need to import from the same source:

  1. Open the Load Existing Playlist dropdown at the top of the page.
  2. Select your saved playlist name.
  3. The field mappings load instantly.
  4. Just paste your new data and click Preview Import.
Tip: Create separate playlists for each data source you work with. This saves you from reconfiguring everything each time.

How to Delete a Saved Playlist

When you no longer need a saved configuration.

  1. Select the playlist from the Load Existing Playlist dropdown.
  2. Click the Delete button next to the playlist dropdown.
  3. 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).

  1. Upload your CSV file to your server using FTP or your hosting control panel.
  2. Note the full server path to the file (like /home/username/imports/models.csv).
  3. Set up your field mappings as usual.
  4. Instead of pasting data in the text box, enter the full file path in the CSV File Path field.
  5. Click Preview Import.
  6. The system reads the file and shows you the preview.
  7. 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:

Field Name What It's For Notes
Model Name The model's stage name or professional name Required for every row
Model Alias Alternative name or real name Optional
Gender Gender identity Options: Female, Male, Trans, Non-binary, Other
Age Current age in years Whole number
Date of Birth Birthdate Format: YYYY-MM-DD (like 1995-06-15)
Body Type Body build description Options: Slim, Athletic, Average, Curvy, Plus-size
Ethnicity Ethnic background Options: Asian, Black, Hispanic, White, Mixed, Other
Eye Color Eye color Options: Blue, Brown, Green, Hazel, Gray
Hair Color Hair color Options: Black, Blonde, Brown, Red, Gray, Other
Weight Weight in kilograms Whole number
Height Height in centimeters Whole number
Measurements Body measurements Format: Bust-Waist-Hips (like 34-26-36)
Cup Size Bra cup size Options: A, B, C, D, DD, Larger
Hair (Pubic) Pubic hair style Options: Shaved, Trimmed, Natural, Bushy, Landing
City City of residence Any text
Country Country of residence Any text
Website URL Personal website address Full URL
Direct Feed URL Live cam feed URL Full URL
Social Media Links Social media profiles Any text
Iframe Embed Embed code for external content HTML code
Tags Keywords for searching Comma-separated words
About Me Biography or description Any text
Cam Score Cam site rating score Decimal number
Popularity Score Overall popularity rating Decimal number
Rating Star rating value Number (usually 1-5)
Rating Amount Number of ratings received Whole number
Model Viewed Total view count Whole number
Comments Count Number of comments Whole number
Subscribers Count Number of subscribers Whole number
Status Publication status Options: Active, Inactive, Pending, Deleted
Image Width Profile image width in pixels Number between 50-2000
Image Height Profile image height in pixels Number between 50-2000
Image URL Web address of profile picture Full URL (system downloads automatically)
Last Active Last activity date and time Format: YYYY-MM-DD HH:MM:SS
N/A (Skip) Ignore this column Use when your data has columns you don't need
Note: Every model must have a Model Name. Rows without a name are skipped. All other fields are optional.
Warning: Each field can only be used once. You can't map two different columns to "Age," for example. The system will show an error if you try.

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

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

Tip:
  • 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:

  1. 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).
  2. Make sure your field mappings match the order of columns in your data.
  3. 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:

  1. Go to Admin Panel > Models and check if the models are there.
  2. Look at the Status column. Only models with status "Active" appear on the public site.
  3. 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:

  1. This means a model with that exact name already exists in your database.
  2. If you want to add them anyway, give them a slightly different name in your data (like "Jane Doe 2").
  3. 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:

  1. Check that the image URLs in your data are complete and start with http:// or https://.
  2. Try opening one of the URLs in your browser to verify the images are accessible.
  3. Some images might be behind login walls or have access restrictions - those can't be downloaded automatically.
  4. 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:

  1. If you're importing images, this is normal. Each image can take time to download.
  2. Wait it out - the import will complete. The log panel will continue showing activity.
  3. 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:

  1. Go to Admin Panel > Models and see if the count of models increased.
  2. The import will finish eventually (check back in 5-10 minutes for large imports).
  3. There's no way to cancel an import once it starts, so let it finish.

 


Page When to Use It
Models View, edit, and manage individual model profiles after importing them
AI Model Data Update Automatically enhance imported model profiles with AI-generated descriptions and tags
Video Management Link imported models to videos on your site
Cam Performers Manage live cam streaming settings for imported models

Important Notes

Warning: Deleting is permanent: Once models are imported, if you delete them, there's no undo button. Always test with a small batch first.
Note: Character limits: The system automatically removes quotation marks, backslashes, and angle brackets from imported data for security. Plan accordingly if your data contains these characters.
Tip: Demo mode: If your site is in demo mode, the import buttons will appear but won't actually add any data. You'll see an orange warning banner at the top of the page.