What You’ll Learn
Logo Integration
Add logos from URL to any video
Custom Positioning
Place logo anywhere on screen
Opacity Control
Adjust transparency for subtle branding
Size Customization
Control logo dimensions and scaling
Before You Begin
Make sure you have:- A Pictory API key (get one here)
- Node.js or Python installed on your machine
- Logo image file accessible via public URL
- Basic understanding of image positioning
How Logo Placement Works
When you add a logo to your video:- Logo Access - Your logo image is downloaded from the provided URL
- Position Calculation - Logo is placed at the specified screen position
- Size Application - Logo is scaled relative to video dimensions
- Opacity Setting - Transparency level is applied
- Video Rendering - Logo appears on all scenes throughout the video
The logo appears on every scene in your video by default. For scene-specific logos, you can apply logo settings at the scene level instead of the video level.
Complete Example
Understanding the Parameters
Logo Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
logo.url | string | Yes | Public URL to your logo image file |
logo.position | string | No | Logo placement on screen (default: top-right) |
logo.opacity | number | No | Transparency level 0-1 (default: 1.0 = fully opaque) |
logo.scale | number | No | Size relative to video width 0-1 (default: 0.15 = 15%) |
Logo Position Options
Choose where to place your logo on the video:| Position | Location | Best Used For |
|---|---|---|
top-left | Upper left corner | Alternative watermark placement |
top-center | Upper center | Centered branding |
top-right | Upper right corner | Standard watermark (most common) |
center-left | Middle left | Side branding |
center-center | Center of frame | Intro/outro logos |
center-right | Middle right | Side branding |
bottom-left | Lower left corner | Legal/copyright notices |
bottom-center | Lower center | Centered footer branding |
bottom-right | Lower right corner | Alternative watermark |
Opacity Reference
Control how transparent your logo appears:| Opacity Value | Effect | Best Used For |
|---|---|---|
| 0.0 | Fully transparent (invisible) | Testing purposes only |
| 0.3 | Very subtle watermark | Minimal branding, artistic videos |
| 0.5 | Moderately transparent | Subtle brand presence |
| 0.7 | Somewhat transparent | Standard watermarks |
| 0.8 | Slightly transparent | Good balance (recommended) |
| 0.9 | Nearly opaque | Strong brand visibility |
| 1.0 | Fully opaque (no transparency) | Maximum visibility |
Scale (Size) Reference
Control logo size relative to video width:| Scale Value | Percentage | Effect |
|---|---|---|
| 0.05 | 5% | Very small, minimal watermark |
| 0.10 | 10% | Small, subtle branding |
| 0.15 | 15% | Standard size (recommended) |
| 0.20 | 20% | Medium, noticeable branding |
| 0.25 | 25% | Large logo |
| 0.30 | 30% | Very large, dominant logo |
Supported Image Formats
| Format | Extension | Supports Transparency | Recommended For |
|---|---|---|---|
| PNG | .png | Yes | Logos with transparency (best choice) |
| JPG/JPEG | .jpg, .jpeg | No | Photographic logos |
| SVG | .svg | Yes | Vector logos, scalable graphics |
| GIF | .gif | Yes | Static logos (animation not supported) |
Common Use Cases
Professional Watermark
Prominent Branding
Minimal Copyright Notice
Intro/Outro Logo
Best Practices
Choose the Right Logo Image
Choose the Right Logo Image
Prepare your logo file for best results:
- PNG Format: Use PNG with transparent background for clean edges
- High Resolution: Minimum 512x512 pixels for clarity
- Simple Design: Logos with less detail scale better
- Appropriate Colors: Ensure logo is visible on various backgrounds
- Test First: Preview logo on different content types before production
Position for Maximum Impact
Position for Maximum Impact
Select logo placement strategically:
- Top-Right: Standard for watermarks, doesn’t conflict with subtitles
- Top-Left: Alternative for different visual balance
- Avoid Center: Center placement can distract from main content
- Consider Subtitles: Don’t overlap with caption placement (usually bottom)
- Test Visibility: Ensure logo is visible on light and dark scenes
Set Appropriate Opacity
Set Appropriate Opacity
Balance visibility with subtlety:
- Professional Videos: Use 0.7-0.9 for visible but not distracting
- Watermarks: Use 0.5-0.7 for copyright protection
- Branded Content: Use 0.8-1.0 for strong brand association
- Test on Content: Preview on actual video content
- Avoid Too Faint: Below 0.5 may not serve branding purpose
Size Appropriately
Size Appropriately
Choose scale based on video type:
- Standard Videos: 0.12-0.18 works well for most content
- Social Media: 0.10-0.15 for subtle branding
- Corporate Videos: 0.15-0.20 for stronger presence
- Intro/Outro Only: Consider scene-level logos instead
- Consistency: Use same size across all videos for brand recognition
Ensure Logo Accessibility
Ensure Logo Accessibility
Make your logo file accessible to the API:
- Cloud Storage: Upload to Google Drive, Dropbox, AWS S3, or CDN
- Public URL: Ensure the URL is publicly accessible (no authentication)
- Direct Link: Use direct file URL, not preview or viewer links
- Test Access: Open URL in incognito browser to verify
- HTTPS: Use secure HTTPS URLs for best compatibility
Troubleshooting
Logo doesn't appear in video
Logo doesn't appear in video
Problem: Video is created but logo is missing.Solution:
- Verify the logo URL is publicly accessible (test in incognito browser)
- Check that the image file format is supported (PNG, JPG, SVG, GIF)
- Ensure opacity is not set to 0 (which makes logo invisible)
- Confirm the URL is a direct link to the image file
- Try a different image URL to test if it’s a file-specific issue
Logo appears pixelated or blurry
Logo appears pixelated or blurry
Problem: Logo quality is poor in the final video.Solution:
- Use a higher resolution logo image (minimum 512x512 pixels)
- Avoid scaling logo too large (keep scale below 0.3)
- Use PNG or SVG format instead of JPG for sharper edges
- Check source image quality before using
- For vector logos, use SVG format when possible
Logo has white box around it
Logo has white box around it
Problem: Logo appears with a white or colored background instead of being transparent.Solution:
- Use PNG format with transparent background
- Re-export logo with alpha channel (transparency) enabled
- Check original file has transparent background (open in image editor)
- Avoid JPG format which doesn’t support transparency
- Use online tools to remove background if needed
Logo is too big or too small
Logo is too big or too small
Problem: Logo size doesn’t match expectations.Solution:
- Adjust the
scaleparameter (0.05-0.30 range) - Scale is relative to video width, not height
- Test different scale values: 0.10 (small), 0.15 (medium), 0.20 (large)
- Remember larger videos will show logos larger at same scale
- Preview before full production
Logo position is off-center or incorrect
Logo position is off-center or incorrect
Problem: Logo doesn’t appear where expected.Solution:
- Verify position value matches available options
- Position names are case-sensitive (e.g., “top-right” not “Top-Right”)
- Check for typos in position parameter
- Logo is positioned based on its center point
- Try different positions to find best placement
Logo blocks important content
Logo blocks important content
Problem: Logo covers subtitles or key visuals.Solution:
- Move logo to a different position (avoid bottom if using subtitles)
- Reduce logo size (lower scale value)
- Increase transparency (lower opacity to 0.5-0.7)
- Consider placing logo in corner with least content
- Test with actual video content before production
Next Steps
Explore more branding and customization options:Brand Settings
Use complete brand presets for full consistency
Subtitle Styles
Apply saved subtitle styling to videos
Custom Subtitle Style
Create custom subtitle styles inline
Highlight Keywords
Emphasize important words in subtitles
API Reference
For complete technical details, see:- Render Storyboard Video - Full API specification
- Get Job Status - Monitor job status and progress
