Adding a Profile Image
Find the Profile Image Upload
Scroll to the profile image section—you’ll see a circular placeholder orb.
Upload Your Photo
You can upload an image in two ways:Click to Upload:
- Click the upload orb
- Select an image file from your computer
- Drag an image file from your file browser
- Drop it onto the upload orb
Crop Your Image
After selecting an image, the crop editor opens:
- Adjust the crop area by dragging
- Use the zoom slider to resize the image
- The crop is always square (1:1 aspect ratio)
- Preview shows exactly what will be saved
Apply or Skip Cropping
You have two options:
- Crop & Apply - Use the cropped image (recommended)
- Use Original - Skip cropping and use the full image
Supported File Formats
CV Builder accepts the following image formats:- JPEG (.jpg, .jpeg)
- PNG (.png)
- WebP (.webp)
File Size and Dimensions
Restrictions:- Maximum file size: 5 MB (enforced by validation)
- Minimum dimensions: No strict minimum, but higher resolution is better
- Recommended: At least 400×400 pixels for sharp output
- Resizes to 400×400 pixels (optimal for resumes)
- Compresses to reduce file size
- Converts to high-quality JPEG format
- Embeds as base64 in your resume data
Image Upload Component
The profile image upload uses theProfileImageUpload component:
Upload States
Image Cropping Tool
CV Builder uses react-easy-crop for professional image cropping:Crop Controls
- Pan - Click and drag the image to reposition
- Zoom slider - Adjust zoom level from 1× to 3×
- Zoom percentage - Displays current zoom level
- Mouse wheel - Scroll to zoom in/out (when enabled)
Crop Area
The crop area is defined by pixel coordinates:Image Validation
Before uploading, images are validated:Image Optimization Process
When you upload an image, CV Builder:- Validates the file type and size
- Loads the image into the crop editor
- Crops (if you choose “Crop & Apply”)
- Resizes to 400×400 pixels
- Compresses to optimize quality vs. size
- Converts to base64 encoding
- Saves in your resume data
Base64 Encoding
Images are stored as base64 strings in your resume:Converting to Base64
Editing a Profile Image
To change an existing profile image:Click Edit Icon
An overlay appears with two buttons:
- Edit (pencil icon) - Replace the image
- Delete (trash icon) - Remove the image
Removing a Profile Image
To delete your profile image:- Hover over the image in the Personal Details section
- Click the trash icon in the overlay
- The image is removed immediately
- The upload orb returns to its empty state
Removing a profile image doesn’t delete the file—it simply removes the reference from your resume. You can upload a new image anytime.
Best Practices for Profile Photos
Accessibility
The profile image upload is fully accessible:- Keyboard navigation - Use Tab and Enter to interact
- Screen reader support - All actions have ARIA labels
- Alt text - Images include descriptive alt attributes
- Focus indicators - Clear visual focus states
Common Issues
Image upload fails?- Check file format (JPEG, PNG, or WebP only)
- Verify file size is under 5 MB
- Try a different image
- Check browser console for errors
- Ensure JavaScript is enabled
- Try refreshing the page
- Check if your browser supports HTML5 Canvas
- Upload a higher-resolution image
- Avoid zooming in too much during cropping
- Use a source image larger than 400×400 pixels
- Verify the image uploaded successfully
- Check that Personal Details section is not hidden
- Try re-uploading the image
- Ensure PDF generation completed without errors
Mobile Support
Profile image upload works on mobile devices:- Touch support - Tap to upload, pinch to zoom while cropping
- Camera access - Use device camera to take a photo (when supported)
- Mobile-optimized UI - Responsive design for small screens
On mobile, the crop editor is optimized for touch gestures. Use one finger to pan and two fingers to zoom the image.
Storage Considerations
Profile images are stored as base64 in your resume data: Advantages:- No separate file hosting required
- Image is embedded directly in the resume
- Works offline once loaded
- Included in version snapshots
- Base64 increases data size by ~33%
- Optimized to 400×400 keeps size reasonable
- Typical size: 30-50 KB after optimization
Next Steps
- Complete your Personal Details section
- Manage section visibility to control where the image appears
- Save versions with different profile photos for different applications