[{"data":1,"prerenderedAt":357},["ShallowReactive",2],{"docs-individual\u002Fcreating-headshots\u002Fupload-troubleshooting":3},{"article":4,"sectionArticles":177,"categories":334,"relatedArticles":355,"prevArticle":243,"nextArticle":249,"categoryName":345,"error":356},{"id":5,"title":6,"avatar":7,"body":8,"description":169,"docx":7,"extension":170,"meta":171,"navigation":172,"order":7,"path":173,"pdf":7,"pdfLabel":7,"procurementPack":7,"seo":174,"slug":7,"stem":175,"__hash__":176},"content\u002Fdocs\u002Findividual\u002Fcreating-headshots\u002Fupload-troubleshooting.md","Upload Troubleshooting",null,{"type":9,"value":10,"toc":161},"minimark",[11,15,19,24,27,31,38,44,50,56,72,75,85,91,97,103,109,115,121,125,136,140],[12,13,6],"h1",{"id":14},"upload-troubleshooting",[16,17,18],"p",{},"Most upload issues fall into one of a few categories: file format or size problems, face detection failures, or session state issues. This article covers the most common errors and how to resolve them.",[20,21,23],"h2",{"id":22},"how-it-works","How it works",[16,25,26],{},"HeadshotPro validates photos in two stages. First, the file type is checked before attempting an upload. Second, HeadshotPro runs face detection and size checks before storing it. Errors from either stage are shown as notifications on the upload screen.",[20,28,30],{"id":29},"common-issues-and-fixes","Common issues and fixes",[16,32,33,37],{},[34,35,36],"strong",{},"\"Only JPEG and PNG formats are supported\"","\nThe file you selected is not a supported format. HeadshotPro accepts JPEG and PNG on the upload screen. If you have HEIC files from an iPhone, they are converted automatically as long as you use the file picker or phone capture flow — not a direct drag-and-drop of the raw HEIC file in all browsers. If this error appears with a HEIC file, export it as JPEG from your Photos app and re-upload.",[16,39,40,43],{},[34,41,42],{},"\"Image is too small\"","\nThe photo is below the 512 × 512 pixel minimum. Use a higher-resolution photo. Screenshots of photos or thumbnails are often too small. If you are capturing selfies on your phone, use the native camera app rather than a compressed preview.",[16,45,46,49],{},[34,47,48],{},"\"File too large. Maximum size is 50MB.\"","\nThe file exceeds the 50MB limit per photo. Export a smaller version of the image and try again. Photos from modern smartphone cameras are almost always well under this limit unless they are RAW files or uncompressed TIFFs.",[16,51,52,55],{},[34,53,54],{},"\"We could not find any faces in the photo\"","\nFace detection ran but could not locate a recognisable face. This typically happens when:",[57,58,59,63,66,69],"ul",{},[60,61,62],"li",{},"The face is turned away from the camera or at an extreme angle.",[60,64,65],{},"The photo is too dark, blurry, or low resolution for detection to work.",[60,67,68],{},"Sunglasses or a hat obscure enough of the face to prevent detection.",[60,70,71],{},"There is no face at all in the image (e.g. a landscape or object photo).",[16,73,74],{},"Fix: use a clear, well-lit photo where your face is front-facing and fills a meaningful portion of the frame.",[16,76,77,80,81,84],{},[34,78,79],{},"Photo appears in \"Bad photos\" section","\nBad photos are images HeadshotPro flagged as unlikely to produce quality headshots. They do not count toward your accepted photo total. Click ",[34,82,83],{},"Show photo requirements"," on the upload screen for a visual guide to what passes and what does not. Delete the flagged photos and replace them with better ones.",[16,86,87,90],{},[34,88,89],{},"\"You already uploaded this photo\"","\nHeadshotPro detects duplicate uploads automatically. The duplicate is discarded. If you want to replace a photo, delete the original version first, then upload the new one.",[16,92,93,96],{},[34,94,95],{},"Photos uploaded from my phone are not appearing","\nPhone photos sync to your desktop session automatically, but there can be a short delay of a few seconds to a few minutes. Wait a moment and then refresh the page. The page updates automatically in the background, but a manual refresh will load any photos that arrived since your last check.",[16,98,99,102],{},[34,100,101],{},"The Continue button is disabled \u002F not activating","\nThe Continue button requires at least 1 accepted (green checkmark) photo. Bad photos (red section) do not count. Check that you have at least 1 photo with a green checkmark. If photos are still in the \"Checking\" state (spinning), wait for them to finish processing.",[16,104,105,108],{},[34,106,107],{},"Upload fails with a generic error or the page freezes","\nThis is usually a network interruption. Check your internet connection, refresh the page, and try uploading again. Your previously uploaded photos are saved to your session — they will reappear after you refresh. You do not need to start over.",[16,110,111,114],{},[34,112,113],{},"\"Model not found or already onboarded\"","\nThis error occurs if you try to upload a photo to a session that has already been submitted. Once you click Submit on the confirmation screen, the session is locked. If you need to make changes, contact support.",[16,116,117,120],{},[34,118,119],{},"Cannot proceed past the intro screen \u002F \"You do not have enough credits\"","\nYou need a valid package or credit assigned to your account before you can start an upload session. If you see this error, verify your purchase completed successfully. Check your email for a payment confirmation. If payment succeeded but the error persists, contact support with your order details.",[20,122,124],{"id":123},"good-to-know","Good to know",[57,126,127,130,133],{},[60,128,129],{},"If an uploaded photo expires (after roughly 24 hours away from the session), HeadshotPro will attempt to reload it automatically. If the photo cannot be reloaded, it is removed from your session and you will need to re-upload it.",[60,131,132],{},"Deleting a photo removes it permanently. This action cannot be undone.",[60,134,135],{},"If you close the browser mid-upload, any photos that finished uploading before you closed are saved. Photos that were still in a \"pending\" (spinning) state at the time are lost and need to be re-uploaded.",[20,137,139],{"id":138},"related","Related",[57,141,142,149,155],{},[60,143,144],{},[145,146,148],"a",{"href":147},"\u002Fdocs\u002Findividual\u002Fcreating-headshots\u002Fuploading-photos","Uploading Your Photos",[60,150,151],{},[145,152,154],{"href":153},"\u002Fdocs\u002Findividual\u002Fcreating-headshots\u002Fphoto-guidelines","Photo Guidelines",[60,156,157],{},[145,158,160],{"href":159},"\u002Fdocs\u002Findividual\u002Fcreating-headshots\u002Fprocessing-and-training","Processing and Training",{"title":162,"searchDepth":163,"depth":163,"links":164},"",2,[165,166,167,168],{"id":22,"depth":163,"text":23},{"id":29,"depth":163,"text":30},{"id":123,"depth":163,"text":124},{"id":138,"depth":163,"text":139},"Solutions to common photo upload issues in HeadshotPro, including file errors, rejected photos, and session problems","md",{},true,"\u002Fdocs\u002Findividual\u002Fcreating-headshots\u002Fupload-troubleshooting",{"title":6,"description":169},"docs\u002Findividual\u002Fcreating-headshots\u002Fupload-troubleshooting","kK61IjjetnYOVzyLhahNYPkXuylbZRu6OvFm8IDsJjM",[178,184,189,194,200,205,210,215,220,226,231,234,239,243,248,249,254,257,263,268,273,279,284,289,294,299,304,309,314,319,324,329],{"title":179,"description":180,"path":181,"dir":182,"slug":183},"Deleting Your Data","How to delete your HeadshotPro account, what data is removed, and what cannot be recovered afterward.","\u002Fdocs\u002Findividual\u002Faccount\u002Fdeleting-your-data","\u002Fdocs\u002Findividual\u002Faccount","deleting-your-data",{"title":185,"description":186,"path":187,"dir":182,"slug":188},"Managing Your Account","How to update your profile information, change your profile picture, change your email or password, and manage email preferences.","\u002Fdocs\u002Findividual\u002Faccount\u002Fmanaging-your-account","managing-your-account",{"title":190,"description":191,"path":192,"dir":182,"slug":193},"Referral Program","How to share your referral link, what your referred friends receive, and how you earn rewards when they purchase.","\u002Fdocs\u002Findividual\u002Faccount\u002Freferral-program","referral-program",{"title":195,"description":196,"path":197,"dir":198,"slug":199},"Buying and Redeeming Gift Cards","How gift cards are purchased, distributed, and redeemed on HeadshotPro.","\u002Fdocs\u002Findividual\u002Fbilling\u002Fbuying-and-redeeming-gift-cards","\u002Fdocs\u002Findividual\u002Fbilling","buying-and-redeeming-gift-cards",{"title":201,"description":202,"path":203,"dir":198,"slug":204},"Checkout Process","Step-by-step guide to completing a HeadshotPro purchase","\u002Fdocs\u002Findividual\u002Fbilling\u002Fcheckout-process","checkout-process",{"title":206,"description":207,"path":208,"dir":198,"slug":209},"Credits and Pricing","How the HeadshotPro credit system works and what each package includes","\u002Fdocs\u002Findividual\u002Fbilling\u002Fcredits-and-pricing","credits-and-pricing",{"title":211,"description":212,"path":213,"dir":198,"slug":214},"Invoices and Receipts","How to access your billing history, view invoices, and export receipts","\u002Fdocs\u002Findividual\u002Fbilling\u002Finvoices-and-receipts","invoices-and-receipts",{"title":216,"description":217,"path":218,"dir":198,"slug":219},"Refund Policy","HeadshotPro's money-back guarantee, eligibility, and how to request a refund","\u002Fdocs\u002Findividual\u002Fbilling\u002Frefund-policy","refund-policy",{"title":221,"description":222,"path":223,"dir":224,"slug":225},"Choosing Headshot Styles","How to browse and select backdrop and outfit combinations during the headshot creation flow.","\u002Fdocs\u002Findividual\u002Fcreating-headshots\u002Fchoosing-styles","\u002Fdocs\u002Findividual\u002Fcreating-headshots","choosing-styles",{"title":227,"description":228,"path":229,"dir":224,"slug":230},"Outfit and Clothing Options","How clothing selection works when pairing outfits with backdrops for AI-generated headshots.","\u002Fdocs\u002Findividual\u002Fcreating-headshots\u002Foutfit-and-clothing-options","outfit-and-clothing-options",{"title":154,"description":232,"path":153,"dir":224,"slug":233},"Practical tips for taking great photos that produce the best AI headshots","photo-guidelines",{"title":235,"description":236,"path":237,"dir":224,"slug":238},"Photo Standards","Technical requirements, file formats, and automatic validation checks for uploaded photos","\u002Fdocs\u002Findividual\u002Fcreating-headshots\u002Fphoto-standards","photo-standards",{"title":240,"description":241,"path":159,"dir":224,"slug":242},"Processing and Generation","What HeadshotPro does with your photos after you submit — from validation to AI headshot generation","processing-and-training",{"title":244,"description":245,"path":246,"dir":224,"slug":247},"Reviewing Your Photos","Understand the photo review screen, the advisory warning tags, and the confirmation checklist before generating your headshots","\u002Fdocs\u002Findividual\u002Fcreating-headshots\u002Freviewing-your-photos","reviewing-your-photos",{"title":6,"description":169,"path":173,"dir":224,"slug":14},{"title":250,"description":251,"path":252,"dir":224,"slug":253},"Uploading from Your Phone","How to use the QR code flow or mobile browser to capture and upload selfies from your phone","\u002Fdocs\u002Findividual\u002Fcreating-headshots\u002Fuploading-from-phone","uploading-from-phone",{"title":148,"description":255,"path":147,"dir":224,"slug":256},"How to upload your photos to HeadshotPro using the upload interface","uploading-photos",{"title":258,"description":259,"path":260,"dir":261,"slug":262},"Choosing a Package","Compare HeadshotPro's three individual packages — Basic, Professional, and Executive — to find the right fit for your needs.","\u002Fdocs\u002Findividual\u002Fgetting-started\u002Fchoosing-a-package","\u002Fdocs\u002Findividual\u002Fgetting-started","choosing-a-package",{"title":264,"description":265,"path":266,"dir":261,"slug":267},"Creating Your First Headshots","A step-by-step walkthrough of the full HeadshotPro flow, from selecting a package through to downloading your results.","\u002Fdocs\u002Findividual\u002Fgetting-started\u002Fcreating-your-first-headshots","creating-your-first-headshots",{"title":269,"description":270,"path":271,"dir":261,"slug":272},"What is HeadshotPro","HeadshotPro generates studio-quality AI headshots from your selfies — no photographer, no studio, no scheduling.","\u002Fdocs\u002Findividual\u002Fgetting-started\u002Foverview","overview",{"title":274,"description":275,"path":276,"dir":277,"slug":278},"Advanced Editing and Remix","How to use advanced editing controls and quick-edit options to produce new headshot variations.","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Fadvanced-editing","\u002Fdocs\u002Findividual\u002Fyour-headshots","advanced-editing",{"title":280,"description":281,"path":282,"dir":277,"slug":283},"Background and Style Editing","How to change backdrops, swap outfits, and apply style changes to your generated headshots.","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Fbackground-and-style-editing","background-and-style-editing",{"title":285,"description":286,"path":287,"dir":277,"slug":288},"Creating Profile Pictures","How to turn your AI headshots into polished profile pictures with custom backgrounds, shapes, and styling.","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Fcreating-profile-pictures","creating-profile-pictures",{"title":290,"description":291,"path":292,"dir":277,"slug":293},"Downloading Headshots","How to download individual photos or your full set as a ZIP file","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Fdownloading-headshots","downloading-headshots",{"title":295,"description":296,"path":297,"dir":277,"slug":298},"Editing Headshots: Overview","A summary of every way you can edit and customize your generated headshots after a shoot completes.","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Fediting-overview","editing-overview",{"title":300,"description":301,"path":302,"dir":277,"slug":303},"Headshot Quality","What affects the quality of your AI headshots and how to get the best results","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Fheadshot-quality","headshot-quality",{"title":305,"description":306,"path":307,"dir":277,"slug":308},"LinkedIn Photo Optimizer","How to use the Profile Picture editor to prepare your headshot for LinkedIn","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Flinkedin-photo-optimizer","linkedin-photo-optimizer",{"title":310,"description":311,"path":312,"dir":277,"slug":313},"Profile Picture Formats","Output format, dimensions, and shape options for profile pictures created in HeadshotPro.","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Fprofile-picture-formats","profile-picture-formats",{"title":315,"description":316,"path":317,"dir":277,"slug":318},"Regenerating Headshots","How to request new headshots when you're not satisfied, and how retries and credits work","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Fregenerating-headshots","regenerating-headshots",{"title":320,"description":321,"path":322,"dir":277,"slug":323},"Sharing Headshots","How to share your HeadshotPro results with others via a shareable link.","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Fsharing-headshots","sharing-headshots",{"title":325,"description":326,"path":327,"dir":277,"slug":328},"Viewing Your Headshots","How to navigate the results gallery and review your generated headshots","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Fviewing-your-headshots","viewing-your-headshots",{"title":330,"description":331,"path":332,"dir":277,"slug":333},"Voting and Feedback","How to get friends or colleagues to vote on your headshots so you can pick the best one.","\u002Fdocs\u002Findividual\u002Fyour-headshots\u002Fvoting-and-feedback","voting-and-feedback",[335,339,343,347,351],{"slug":336,"name":337,"articles":338},"account","Account",[178,184,189],{"slug":340,"name":341,"articles":342},"billing","Billing",[194,200,205,210,215],{"slug":344,"name":345,"articles":346},"creating-headshots","Creating Headshots",[220,226,231,234,239,243,248,249,254],{"slug":348,"name":349,"articles":350},"getting-started","Getting Started",[257,263,268],{"slug":352,"name":353,"articles":354},"your-headshots","Your Headshots",[273,279,284,289,294,299,304,309,314,319,324,329],[],false,1792738471117]