Documentación de ComusThumbz
HTML Markdown Imprimir/PDF Texto Plano
Iniciar Sesión

Menú de Documentación


Acceso de Administrador

Modelos Importación a granel

 

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

Lo que ves: El contador "Images Failed" es alto o todas las descargas de imágenes fallaron.

Cómo arreglarlo:

  1. Compruebe que las URL de la imagen en sus datos están completas y empezar con http:// o https://.
  2. Intente abrir una de las URL en su navegador para verificar que las imágenes sean accesibles.
  3. Algunas imágenes podrían estar detrás de las paredes de acceso o tener restricciones de acceso - que no se pueden descargar automáticamente.
  4. Compruebe que su servidor tiene permiso para escribir a la carpeta de imágenes (el sistema crea esto automáticamente, pero algunos servidores tienen permisos estrictos).

La importación lleva mucho tiempo

Lo que ves: La barra de progreso se mueve muy lentamente o aparece atascada.

Cómo arreglarlo:

  1. Si estás importando imágenes, esto es normal. Cada imagen puede tomar tiempo para descargar.
  2. Espérenlo - la importación se completará. El panel de registro continuará mostrando actividad.
  3. Para futuras importaciones, considere importar datos sin imágenes primero, a continuación, añadir imágenes por separado.

Cerré la pestaña del navegador durante la importación

Lo que ves: Cerró accidentalmente o refrescó la página mientras la importación estaba corriendo.

¿Qué pasa?
La importación continúa corriendo en el servidor aunque haya cerrado la ficha. Sin embargo, no puede volver a la pantalla de progreso para esa importación específica.

Cómo comprobar:

  1. Ve. Panel de Admin Modelos y ver si el conteo de modelos aumentó.
  2. La importación terminará eventualmente (ver atrás en 5-10 minutos para grandes importaciones).
  3. No hay manera de cancelar una importación una vez que comience, así que déjalo terminar.

PáginaCuándo utilizarlo
ModelosVer, editar y gestionar perfiles de modelos individuales después de importarlos
Actualización de datos modelo AIMejorar automáticamente los perfiles de modelos importados con descripciones y etiquetas generadas por AI
Gestión de vídeoEnlace de modelos importados a vídeos en su sitio
Cam PerformersGestione los ajustes de transmisión de cámaras en vivo para los modelos importados

Notas importantes

Advertencia: Eliminar es permanente: Una vez que los modelos son importados, si los eliminas, no hay botón deshacer. Siempre prueba con un lote pequeño primero.
Nota: Límites de carácter: El sistema elimina automáticamente las comillas, las barras y los corchetes de ángulo de los datos importados para la seguridad. Planifique en consecuencia si sus datos contienen estos caracteres.
Sugerencia: Modo de demostración: Si su sitio está en modo de demostración, los botones de importación aparecerán pero en realidad no añadirán ningún dato. Verás una bandera de advertencia naranja en la parte superior de la página.

Related Pages