Integrate FastPix with WordPress

This guide shows you how to connect your WordPress site to FastPix using the FastPix Video Uploader plugin. After you complete the setup, you can upload, manage, and embed videos from your FastPix account directly in the WordPress editor.

Before you begin

Before you start, make sure you have:

• A WordPress site (version 5.0 or later recommended)
• Admin access to your WordPress dashboard
• A FastPix account (sign up if you don't have one)

NOTE:
If you use WordPress.com, you need a Business plan or higher to install plugins. Self-hosted WordPress installations don't have this restriction.

Supported formats

The plugin supports the following video formats:

• Video formats: MP4, MOV, AVI, MKV, WMV, FLV, WebM
• Maximum file size: 50 GB
• Recommended codecs: H.264, H.265, VP9

Install the plugin

You can install the FastPix Video Uploader plugin using either the WordPress Plugin Directory or manual upload.

Install from the Plugin Directory

1. In your WordPress admin panel, go to Plugins > Add New.
2. In the search bar, enter FastPix video uploader.
3. When the plugin appears in the results, click Install Now.
4. After installation completes, click Activate.

Install manually

1. Download the plugin ZIP file from wordpress.org.
2. In your WordPress admin panel, go to Plugins > Add New > Upload Plugin.
3. Click Choose File and select the downloaded ZIP file.
4. Click Install Now.
5. After installation completes, click Activate.

After activation, the plugin appears in your Installed Plugins list.

Get your FastPix API credentials

To connect WordPress to your FastPix account, generate your API credentials by following the steps in the Activate account guide.

IMPORTANT:
These credentials authenticate all video operations from WordPress, including uploads, playback, and metadata management. Make sure the API key has Video: Read + Write, Data Read and System permissions enabled.

Connect the plugin to FastPix

After you install the plugin and obtain your API credentials:

1. In your WordPress admin panel, go to FastPix Video > Settings.
2. Paste your FastPix Access token ID in the API Key field.
3. Paste your FastPix Secret Key in the API Secret field.
4. Click Save Settings.

The plugin validates your credentials with FastPix. When validation succeeds, you see a success message confirming the connection.

Upload videos

After you connect your FastPix account, you can upload videos directly from WordPress.

To upload a video:

1. In your WordPress admin panel, go to FastPix Video > Upload Video.
2. Do one of the following:
   • Drag a video file into the upload area
   • Click Browse and select a file from your computer
3. Configure the following upload options:
   • Privacy: Select Public for unrestricted access or Protected for secured playback
   • Quality: Choose your preferred output quality (for example, 1080p or 720p)
   • Subtitles: Enable auto-generated captions or upload custom subtitle files
   • MP4 Generation: Enable this option to create downloadable MP4 files
4. Click Upload.
5. Monitor the progress bar until the upload and processing are complete.

After processing completes, your video appears in the FastPix Media Library.

Embed videos in posts and pages

You can add FastPix videos to any WordPress post or page using a shortcode.

Add a video using the shortcode

To embed a video, add the following shortcode to your post or page:

[fastpix playback_id="your_playback_id" width="640" height="360"]

Shortcode parameters

The shortcode accepts the following parameters:

Example

[fastpix playback_id="abc123def456" width="800" height="450"]

Find your video's playback ID

To get the playback ID for a video:

1. In your WordPress admin panel, go to FastPix Video > Video Library.
2. Click the video you want to embed.
3. In the video details panel, find the Playback ID field.
4. Copy the playback ID and paste it into your shortcode.

When you publish your post or page, WordPress renders the FastPix video player with your specified configuration.

Manage videos

You can view and manage all uploaded videos from the Video Library.

Access the Video Library

To view your videos:

1. In your WordPress admin panel, go to FastPix Video > Video Library.
2. Browse your videos. Each entry shows:
   • Thumbnail preview
   • Video status
   • Key metadata (video ID, duration, upload date)

View video details

To view detailed information about a video:

1. In the Video Library, click a video.
2. The Video Details modal displays the following information:
   • Video information: Duration, resolution, frame rate, aspect ratio
   • Download links: Access to generated MP4 or audio-only files
   • Subtitles: Options to add, edit, or remove subtitle tracks
   • Shortcode: Ready-to-use shortcode for embedding

From this modal, you can also manage privacy settings and playback options.

Configure advanced settings

Set video quality

When you upload a video, you can select the quality level for processing. FastPix offers multiple quality tiers to ensure smooth streaming across different devices and network conditions.

Generate MP4 files

To create downloadable MP4 versions of your videos:

1. During upload, enable the MP4 Generation option.
2. Select one of the following:
   • High Resolution: Creates the highest quality MP4 file
   • Audio Only: Creates an M4A file for audio-only playback
   • Both: Generates both video and audio-only files

After generation completes, you can access MP4 files from the Video Details page.

Control video privacy

You can set video access permissions when uploading:

• Public: Anyone can play the video without restrictions
• Protected: Playback requires FastPix access control and token-based validation

Add captions and subtitles

FastPix supports both automatic and manual caption creation.

Supported caption options

• Languages: English, Spanish, Italian, Portuguese, German, French
• File formats: .srt, .vtt

Add captions to an existing video

To add captions:

1. Go to FastPix Video > Video Library.
2. Click the video you want to add captions to.
3. In the Video Details page, click Add Subtitle.
4. Select the caption type:
   • Auto-Generated: FastPix generates captions during video processing
   • Custom: Upload your own subtitle file
5. If you selected Custom, choose your subtitle file (.srt or .vtt format).

Technical features

Chunked upload support

The plugin uses chunked uploads for reliable file transfers:

• Chunk size: 16 MB per chunk for stable transfers
• Resume capability: Automatically retries failed chunks after network interruptions
• Progress tracking: Displays real-time upload progress
• Browser compatibility: Works in Chrome, Firefox, Safari, and Edge

Error handling

The plugin includes comprehensive error handling:

• Network issues: Automatic retry with exponential backoff
• File validation: Checks file type and size before upload
• Credential validation: Verifies API credentials automatically
• User feedback: Displays clear, actionable error messages

Security

The plugin follows WordPress and FastPix security best practices:

• Nonce verification: Prevents unauthorized requests
• Credential encryption: Stores API keys securely in the database
• Input sanitization: Validates and sanitizes all user input
• Access control: Uses role-based WordPress capability checks

Performance optimization

FastPix provides the following performance features:

• Lazy loading: Videos load only when visible on the page
• CDN delivery: Uses the FastPix global CDN for optimal performance
• Caching: Implements efficient caching strategies to minimize repeat loads
• Automatic compression: Compresses videos automatically for faster playback

Troubleshooting

Upload fails

If your upload fails, try the following:

• Verify your API credentials in FastPix Video > Settings.
• Check that your file format is supported and doesn't exceed 50 GB.
• Ensure you have a stable internet connection.
• Try uploading a smaller file to test your connection.

Video doesn't play

If your video doesn't play, check the following:

• Verify that video processing has completed in FastPix.
• Confirm you're using the correct playback ID in your shortcode.
• Check that the video's privacy setting allows playback.
• Clear your browser cache and try again.

Subtitles don't display

If subtitles don't appear, verify the following:

• The subtitle language matches the video's audio language.
• The subtitle file format is .srt or .vtt.
• Subtitle processing has completed in FastPix.
• Subtitles are enabled in the video player controls.

What's next

• Read the complete FastPix documentation guides
• Explore FastPix API documentation
• Join the FastPix community discusssions
• Contact FastPix support