Saved Extensions

Create reusable extension configurations for AI tasks, auto-tagging, background removal, and more. Apply saved extensions across your media library via UI or API.

•

Saved extensions let you create reusable configurations for any ImageKit extension and apply them across multiple files. Instead of defining complex extension JSON repeatedly, create it once, save it, and reference it by ID.

Key benefits:

Reusability: Define complex configurations once, use everywhere.
Consistency: Ensure the same processing logic across all files.
Team collaboration: Share standardized configurations across your organization.
Simplified API calls: Reference by ID instead of including full JSON configuration.

Supported extension types

Saved extensions work with all ImageKit extensions:

Extension Type	Common Use Cases
AI tasks	Product categorization, brand compliance, quality control with controlled vocabularies
Auto-tagging	General image categorization and discovery with free-form AI tags
Auto-description	Accessibility, SEO, and content management with AI-generated descriptions
Remove background	Product photography, e-commerce, and graphic design automation

The primary benefit is for AI tasks with complex JSON configurations containing multiple tasks, vocabularies, and conditional logic—instead of copying 20+ lines of JSON every time, simply reference the saved extension ID.

Managing saved extensions via dashboard

Creating a saved extension

Go to Settings → Media Library → Saved Extensions and click Add New.

Fill in the form:

Name: Descriptive name for the extension (e.g., "Product Image Classifier")
Description: Explain what this extension does
Configuration: The complete extension JSON

Click Create to save.

Viewing saved extensions

All saved extensions are listed at Settings → Media Library → Saved Extensions with their names, descriptions, and IDs.

Click any extension to view its full configuration.

Editing and deleting

Click the three-dot menu on any saved extension to Edit or Delete it.

Changes to saved extensions apply to future uses only. Files already processed with the old configuration are not affected.

Managing saved extensions via API

Use the Saved Extensions API for programmatic CRUD operations:

The API returns a unique id for each saved extension, which you use in upload and update operations.

Using saved extensions

During upload (UI)

When uploading files, expand Settings and select saved extensions from the list.

All selected files will be processed with the chosen saved extensions.

On existing files (UI)

Select files in Media Library → Right-click → Apply Saved extensions → Choose from the list → Apply

During upload (API)

Reference the saved extension ID in the extensions parameter:

Copy

curl -X POST 'https://upload.imagekit.io/api/v2/files/upload' \
  -u private_key: \
  -F 'file=@image.jpg' \
  -F 'fileName=image.jpg' \
  -F 'extensions=[{
    "name": "saved-extension",
    "id": "ext_abc123def456"
  }]'

On existing files (API)

Use the Update File Details API:

Copy

curl -X PATCH 'https://api.imagekit.io/v1/files/:fileId/details' \
  -H 'Content-Type: application/json' \
  -u private_key: \
  -d '{
    "extensions": [{
      "name": "saved-extension",
      "id": "ext_abc123def456"
    }]
  }'