Upload Channels

ImageKit Upload Setup Guide

13 Aug, 2025 8 min read

ImageKit is a comprehensive image optimization and transformation service that offers real-time image processing, CDN delivery, and media management. This guide will help you configure ImageKit for storing and optimizing screenshots from your monitoring tasks.

About ImageKit

ImageKit provides automatic image optimization, format conversion, dynamic transformations, and global CDN delivery. Perfect for fast, optimized screenshot storage.

Features and benefits

Real-time optimization

Automatic image optimization, format conversion, and quality adjustment based on device and browser capabilities.

Dynamic transformations

Apply resize, crop, watermark, and filters on-the-fly via URL parameters.

Global CDN

Fast image delivery through a global CDN network with intelligent caching and compression.

Media management

Complete digital asset management with folders, tags, metadata, and version control.

Step 1: Create ImageKit Account

Sign up for a free or paid ImageKit account:

  1. Visit https://imagekit.io/registration
  2. Create your account with email and password
  3. Verify your email address
  4. Complete the onboarding process

Step 2: Get API Credentials

Obtain your API keys from the ImageKit dashboard:

  1. Log in to your ImageKit dashboard
  2. Navigate to Developer → API Keys in the sidebar
  3. Copy your Public Key, Private Key, and URL Endpoint
  4. Store these credentials securely – you will need them for configuration

Security note

Never expose your Private Key in client-side code. Keep it secure in your server environment only.

Step 3: Configure Upload Channel

Set up ImageKit in your tracking application:

  1. Go to Upload Channels in your admin panel
  2. Click "Add New Channel"
  3. Select "ImageKit" as the channel type
  4. Fill in the required credentials:
    • Public Key: Your ImageKit public API key
    • Private Key: Your ImageKit private API key
    • URL Endpoint: Your ImageKit URL endpoint (e.g. https://ik.imagekit.io/your_id)
  5. Configure optional settings (folder, tags, file naming)
  6. Test the connection and save

Optional configuration

  • Folder: Organize uploads in specific folders (e.g. screenshots, tracking-data)
  • Tags: Add tags for better organization (comma-separated)
  • File naming: Custom file naming pattern using variables like {task_name}, {date}, etc.
  • Custom metadata: Add custom metadata fields for enhanced file management

Configuration example

Public Key: pk_abc123...
Private Key: private_xyz789...
URL Endpoint: https://ik.imagekit.io/your_account_id
Folder: screenshots
Tags: tracking, automated, task-screenshots

Pricing and limits

Free plan

  • 20GB storage
  • 20GB bandwidth
  • 20MB max file size (images)
  • 100MB max file size (videos)
  • Unlimited transformations

Paid plans

  • 40MB max file size (images)
  • 2GB max file size (videos)
  • Higher storage and bandwidth
  • Advanced features
  • Priority support

Troubleshooting

Connection test fails

  • Verify your Public Key, Private Key, and URL Endpoint are correct
  • Ensure your API keys have upload permissions
  • Check if your ImageKit account is active and in good standing
  • Verify there are no firewall restrictions blocking API calls

Upload failures

  • Check if the file size exceeds your plan limits
  • Ensure the file format is supported by ImageKit
  • Verify the folder path exists or can be created
  • Check your account's storage and bandwidth limits

File organization issues

  • Use forward slashes (/) for folder paths, not backslashes
  • Folder names should not contain special characters except hyphens and underscores
  • Ensure custom metadata fields are created in ImageKit dashboard before use

Additional resources

Tokens cost

ImageKit uploads cost 3 additional tokens per upload. This includes image optimization, CDN delivery, and all transformations applied to your screenshots.

Setup complete

Once configured, your tracking tasks will automatically upload screenshots to ImageKit with real-time optimization and global CDN delivery. You can view and manage all uploaded files in your ImageKit Media Library.

Set up ImageKit uploads

Configure ImageKit integration for optimized screenshot storage and delivery.

Add upload channel

Still need help?

Our support team is available to help you with any questions.