[{"data":1,"prerenderedAt":389},["ShallowReactive",2],{"docs-team-lead\u002Fteam-headshots\u002Fbulk-uploading-photos":3},{"article":4,"sectionArticles":197,"categories":366,"relatedArticles":387,"prevArticle":314,"nextArticle":321,"categoryName":385,"error":388},{"id":5,"title":6,"avatar":7,"body":8,"description":189,"docx":7,"extension":190,"meta":191,"navigation":192,"order":7,"path":193,"pdf":7,"pdfLabel":7,"procurementPack":7,"seo":194,"slug":7,"stem":195,"__hash__":196},"content\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fbulk-uploading-photos.md","Bulk Uploading Photos",null,{"type":9,"value":10,"toc":181},"minimark",[11,15,19,22,27,30,40,43,47,121,125,162,166],[12,13,6],"h1",{"id":14},"bulk-uploading-photos",[16,17,18],"p",{},"Bulk upload lets a team admin create headshot models for multiple team members in a single session. Instead of sending each member through the individual onboarding flow, you upload one ZIP file per person and submit them all from a single interface. Each submitted ZIP consumes one organization credit and kicks off generation automatically.",[16,20,21],{},"Bulk upload bypasses automatic photo quality checks. You are responsible for ensuring photos meet quality standards before uploading. Poor-quality source photos will produce poor results.",[23,24,26],"h2",{"id":25},"prerequisites","Prerequisites",[16,28,29],{},"Before you can use bulk upload, two conditions must be met:",[31,32,33,37],"ul",{},[34,35,36],"li",{},"Your organization must have the bulk upload feature enabled. If you land on the admin dashboard instead of the bulk upload page, contact your account manager.",[34,38,39],{},"Your organization must have credits available. Each submitted model deducts one credit.",[16,41,42],{},"You select 4 backdrops, 1 male outfit, and 1 female outfit before uploading. These selections apply to every model created in that session.",[23,44,46],{"id":45},"how-it-works","How it works",[48,49,50,58,61,74,77,80,111,118],"ol",{},[34,51,52,53,57],{},"Go to ",[54,55,56],"strong",{},"Admin > Bulk Upload"," in your team dashboard.",[34,59,60],{},"Select 4 backdrops, a male outfit, and a female outfit from the pickers at the top of the page. The upload area only unlocks after all selections are made.",[34,62,63,64,68,69],{},"Prepare your ZIP files. Each ZIP must contain photos for a single person — one ZIP equals one model. Supported image formats inside the ZIP: JPG, JPEG, PNG, HEIC, HEIF, AVIF. Name each ZIP file after the person (e.g., ",[65,66,67],"code",{},"jane-smith.zip",") — the filename becomes the default model title.\n",[31,70,71],{},[34,72,73],{},"Include 1–3 photos per ZIP.",[34,75,76],{},"Drag your ZIP files onto the upload area, or click to open a file picker. You can upload up to 20 ZIP files at once. Uploading more than 20 at a time is not supported — run a second batch if needed.",[34,78,79],{},"The system extracts each ZIP, detects faces, crops each photo automatically, and uploads the processed images. A dual progress bar shows overall batch progress and per-file image progress. Files with no valid faces or unreadable images are skipped with a warning toast.",[34,81,82,83],{},"Once processing completes, a table appears listing every successfully processed file. For each row:\n",[31,84,85,95,101],{},[34,86,87,90,91,94],{},[54,88,89],{},"Title"," — edit the model name. Defaults to the ZIP filename (without the ",[65,92,93],{},".zip"," extension).",[34,96,97,100],{},[54,98,99],{},"Gender"," — select Male or Female. This affects which outfit is used.",[34,102,103,106,107,110],{},[54,104,105],{},"Photos"," — shows a thumbnail and photo count. Click the thumbnail or ",[54,108,109],{},"View all"," to open a photo preview modal where you can also remove individual photos.",[34,112,113,114,117],{},"Click ",[54,115,116],{},"Submit"," on each row to create the model. Submit button is disabled if the title is blank, gender is unset, or the photo count is out of range. Each submitted model immediately deducts one credit and triggers generation.",[34,119,120],{},"Completed rows display a green checkmark. Remaining rows can still be edited and submitted independently.",[23,122,124],{"id":123},"good-to-know","Good to know",[31,126,127,130,133,144,147,150,153,156,159],{},[34,128,129],{},"Processing happens locally before upload. Large batches with many high-resolution photos can take several minutes.",[34,131,132],{},"HEIC and AVIF files are automatically converted to JPEG during processing. No pre-conversion needed.",[34,134,135,136,139,140,143],{},"Mac ZIP files often contain a ",[65,137,138],{},"__MACOSX\u002F"," folder and ",[65,141,142],{},".DS_Store"," files — these are automatically ignored.",[34,145,146],{},"Images where no face is detected are silently skipped. If a ZIP ends up with zero processable photos, it is dropped from the list with an error message.",[34,148,149],{},"Photos where the face covers less than 20% of the frame may be saved as full-body shots (up to 3 per ZIP). The rest are cropped to a headshot.",[34,151,152],{},"The photo modal lets you remove individual photos from a processed ZIP before submitting. Removing photos counts against the minimum photo requirement — you cannot submit if the count drops below the minimum.",[34,154,155],{},"Credits shown in the top-right of the uploaded files table update in real time as you submit models.",[34,157,158],{},"There is no bulk-submit button. Each model is submitted individually, giving you a chance to review titles and gender before committing the credit.",[34,160,161],{},"Models created via bulk upload are tagged so they can be identified separately from individually onboarded models.",[23,163,165],{"id":164},"related","Related",[31,167,168,175],{},[34,169,170],{},[171,172,174],"a",{"href":173},"\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fmanaging-members","Managing Members",[34,176,177],{},[171,178,180],{"href":179},"\u002Fdocs\u002Fteam-lead\u002Fgetting-started\u002Foverview","Getting Started as a Team Admin",{"title":182,"searchDepth":183,"depth":183,"links":184},"",2,[185,186,187,188],{"id":25,"depth":183,"text":26},{"id":45,"depth":183,"text":46},{"id":123,"depth":183,"text":124},{"id":164,"depth":183,"text":165},"Upload ZIP files for multiple team members at once to create headshot models without individual onboarding.","md",{},true,"\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fbulk-uploading-photos",{"title":6,"description":189},"docs\u002Fteam-lead\u002Fteam-headshots\u002Fbulk-uploading-photos","irmCOg3dPe_-j8y7rl8_phSd_3Cu73VHWx4fk3lJ-Sc",[198,204,209,214,219,225,230,235,239,244,249,255,260,265,271,276,281,286,289,294,299,304,309,314,320,321,326,331,336,341,346,351,356,361],{"title":199,"description":200,"path":201,"dir":202,"slug":203},"Billing History","Where to find invoices and receipts, add your company details to them, and read the credit activity log.","\u002Fdocs\u002Fteam-lead\u002Fbilling\u002Fbilling-history","\u002Fdocs\u002Fteam-lead\u002Fbilling","billing-history",{"title":205,"description":206,"path":207,"dir":202,"slug":208},"Credits Overview","How team credits work: when a credit is used, what happens when someone leaves, edit credits, and how to track usage.","\u002Fdocs\u002Fteam-lead\u002Fbilling\u002Fcredits-overview","credits-overview",{"title":210,"description":211,"path":212,"dir":202,"slug":213},"Purchasing Credits","How to buy credits for your team: payment methods, the volume discount ladder, invoices for large orders, and automatic top-up.","\u002Fdocs\u002Fteam-lead\u002Fbilling\u002Fpurchasing-credits","purchasing-credits",{"title":215,"description":216,"path":217,"dir":202,"slug":218},"Refunds for Teams","The 30-day money-back guarantee for team purchases and how to request a refund.","\u002Fdocs\u002Fteam-lead\u002Fbilling\u002Frefunds","refunds",{"title":220,"description":221,"path":222,"dir":223,"slug":224},"Creating a Team Account","How to set up a HeadshotPro team: answer four questions, pick the look, pay, and invite your team.","\u002Fdocs\u002Fteam-lead\u002Fgetting-started\u002Fcreating-a-team","\u002Fdocs\u002Fteam-lead\u002Fgetting-started","creating-a-team",{"title":226,"description":227,"path":228,"dir":223,"slug":229},"Inviting Members","Three ways to add people to your team: email invites, your shareable team link, or uploading photos for them.","\u002Fdocs\u002Fteam-lead\u002Fgetting-started\u002Finviting-members","inviting-members",{"title":231,"description":232,"path":233,"dir":223,"slug":234},"The New AI Model for Teams","What changed with the latest AI model: 2–3 selfies instead of 15, 40 headshots per person, self-serve redos, and how to upgrade an older team.","\u002Fdocs\u002Fteam-lead\u002Fgetting-started\u002Fnew-model","new-model",{"title":236,"description":237,"path":179,"dir":223,"slug":238},"HeadshotPro for Teams: Overview","How HeadshotPro Teams works for organizations: one consistent look, self-serve shoots for every member, and answers to the questions buyers ask first.","overview",{"title":240,"description":241,"path":242,"dir":223,"slug":243},"Overview","Your team dashboard: credits, member progress, pending invites, the team link, and the left menu.","\u002Fdocs\u002Fteam-lead\u002Fgetting-started\u002Fteam-dashboard","team-dashboard",{"title":245,"description":246,"path":247,"dir":223,"slug":248},"Team Link, QR Code and Poster","Your team's permanent join link at headshotpro.com\u002Ft\u002Fyour-company, its QR code, and the printable poster.","\u002Fdocs\u002Fteam-lead\u002Fgetting-started\u002Fteam-link-qr-and-poster","team-link-qr-and-poster",{"title":250,"description":251,"path":252,"dir":253,"slug":254},"API Overview","The HeadshotPro API: what it automates, the three ways to connect your HR tools, and where the full documentation lives.","\u002Fdocs\u002Fteam-lead\u002Fintegrations\u002Fapi-overview","\u002Fdocs\u002Fteam-lead\u002Fintegrations","api-overview",{"title":256,"description":257,"path":258,"dir":253,"slug":259},"Gift Codes","Hand out headshots with redeemable codes instead of a team invite.","\u002Fdocs\u002Fteam-lead\u002Fintegrations\u002Fgift-codes","gift-codes",{"title":261,"description":262,"path":263,"dir":253,"slug":264},"Webhooks and Integrations","Connect HeadshotPro to Zapier or to your own systems with webhooks.","\u002Fdocs\u002Fteam-lead\u002Fintegrations\u002Fwebhooks-and-integrations","webhooks-and-integrations",{"title":266,"description":267,"path":268,"dir":269,"slug":270},"Creating and Managing Teams","How to create, edit, and delete sub-teams within your organization to group members by department","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fcreating-teams","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team","creating-teams",{"title":272,"description":273,"path":274,"dir":269,"slug":275},"Custom Fields","Collect extra information from your team members during their headshot onboarding.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fcustom-fields","custom-fields",{"title":277,"description":278,"path":279,"dir":269,"slug":280},"Customizing Emails","Control which emails your team receives, where admin alerts go, and rewrite the wording of member emails.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fcustomizing-emails","customizing-emails",{"title":282,"description":283,"path":284,"dir":269,"slug":285},"Deleting Your Organization","How the owner deletes a team organization, and how a team lead then deletes their own HeadshotPro account.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fdeleting-your-organization","deleting-your-organization",{"title":174,"description":287,"path":173,"dir":269,"slug":288},"Find any member, see where they are in their shoot, and take action from the Members page.","managing-members",{"title":290,"description":291,"path":292,"dir":269,"slug":293},"Organization Settings","Manage your organization's name, logo, headshot preferences and email notifications.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Forganization-settings","organization-settings",{"title":295,"description":296,"path":297,"dir":269,"slug":298},"Removing Members","Remove a member from your organization, and understand what happens to their data and your credits.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fremoving-members","removing-members",{"title":300,"description":301,"path":302,"dir":269,"slug":303},"Roles and Permissions","Understand the owner, admin and member roles, and how to add or remove admins.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Froles-and-permissions","roles-and-permissions",{"title":305,"description":306,"path":307,"dir":269,"slug":308},"Security Controls","Configure MFA for admins, manage admins, transfer ownership, and set data retention for your organization.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fsecurity-controls","security-controls",{"title":310,"description":311,"path":312,"dir":269,"slug":313},"SSO Setup","Connect your identity provider to HeadshotPro so team members authenticate through your company's existing SSO system.","\u002Fdocs\u002Fteam-lead\u002Fmanaging-your-team\u002Fsso-setup","sso-setup",{"title":315,"description":316,"path":317,"dir":318,"slug":319},"Approving and Managing Headshots","How to review finished member headshots, mark them as handled, and download photos for the whole team","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fapproving-and-managing-headshots","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots","approving-and-managing-headshots",{"title":6,"description":189,"path":193,"dir":318,"slug":14},{"title":322,"description":323,"path":324,"dir":318,"slug":325},"Creating Profile Picture Templates","How to create branded profile picture templates with shape, background, border, outline, and logo overlay settings.","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fcreating-templates","creating-templates",{"title":327,"description":328,"path":329,"dir":318,"slug":330},"Enforcing Consistency","Use the approved list, outfit rules, backdrop settings, per-team overrides and pose selection to keep every team headshot on-brand.","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fenforcing-consistency","enforcing-consistency",{"title":332,"description":333,"path":334,"dir":318,"slug":335},"Headshots Still Preparing","What to expect while a member's headshots generate, and what to do when a shoot looks stuck","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fheadshots-still-preparing","headshots-still-preparing",{"title":337,"description":338,"path":339,"dir":318,"slug":340},"Issuing Retries","How a team member gets a free retry, and how you start a new shoot for them when the retry is used up","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fissuing-retries","issuing-retries",{"title":342,"description":343,"path":344,"dir":318,"slug":345},"Managing Profile Picture Templates","How to edit, delete, set a default, and apply profile picture templates to organization members.","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fmanaging-templates","managing-templates",{"title":347,"description":348,"path":349,"dir":318,"slug":350},"Pose Selection","Restrict which body poses HeadshotPro cycles through when generating headshots for your team.","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fpose-selection","pose-selection",{"title":352,"description":353,"path":354,"dir":318,"slug":355},"Quality Tips","What to tell your team before they upload selfies, and why results sometimes differ from the person","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fquality-tips","quality-tips",{"title":357,"description":358,"path":359,"dir":318,"slug":360},"Style Presets","Choose the backdrops and outfits your team can use, add your own backdrops and outfits, and set a different look per team.","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fstyle-presets","style-presets",{"title":362,"description":363,"path":364,"dir":318,"slug":365},"Viewing Team Headshots","Track every member's shoot from Overview and Members, open their photos, and download headshots in the sizes your organization needs","\u002Fdocs\u002Fteam-lead\u002Fteam-headshots\u002Fviewing-team-headshots","viewing-team-headshots",[367,371,375,379,383],{"slug":368,"name":369,"articles":370},"billing","Billing",[198,204,209,214],{"slug":372,"name":373,"articles":374},"getting-started","Getting Started",[219,225,230,235,239,244],{"slug":376,"name":377,"articles":378},"integrations","Integrations",[249,255,260],{"slug":380,"name":381,"articles":382},"managing-your-team","Managing Your Team",[265,271,276,281,286,289,294,299,304,309],{"slug":384,"name":385,"articles":386},"team-headshots","Team Headshots",[314,320,321,326,331,336,341,346,351,356,361],[],false,1793943946653]