Color Profile
Use the color_profile transformation to control the colorspace policy for a delivered image variant.
Overview
Imgwire normally prepares delivered variants for browser-friendly output. Use color_profile when you need to explicitly convert to a supported colorspace or preserve the source profile policy for a specialized workflow.
Syntax
| Field | Value |
|---|---|
| Canonical parameter | color_profile |
| Aliases | cp, icc |
| Accepted values | srgb, rgb16, cmyk, keep, preserve |
Example
https://cdn.imgwire.dev/{organization_id}/{environment_id}/{image_id}?format=jpg&color_profile=srgb
image.url({
format: 'jpg',
color_profile: 'srgb',
quality: 'auto',
});
imgwire images url img_123 --format jpg --color-profile srgb --quality auto
Choosing a value
| Value | Use when |
|---|---|
srgb | You want browser-friendly sRGB output. |
rgb16 | You need a higher-bit-depth RGB colorspace where supported by the output workflow. |
cmyk | You are producing a variant for a workflow that expects CMYK output. |
keep | You want to avoid forced colorspace conversion. |
preserve | Same intent as keep: preserve the profile policy instead of forcing conversion. |
Best practices
- Use
srgbfor web delivery unless your workflow has a specific profile requirement. - Use
keeporpreserveonly when you know downstream processing expects the original profile behavior. - Pair profile decisions with Strip Color Profile and Strip Metadata intentionally.
Common mistakes
- Preserving profiles by default for browser thumbnails without a reason.
- Assuming profile conversion changes the original uploaded file. It only changes the delivered variant.
- Using CMYK variants in places where browsers and image consumers expect sRGB.
Related pages
Last updated at: May 9, 2026