Meta tags:
description=Learn how to specify the transformations to apply when a condition is met, including chained transformations and examples.;

Headings (most frequently used words):

transformations, with, cloudinary, conditional, transformation, specifying, for, condition, documentation, index, get, started, install, agent, skills, syntax, examples, conditions, chained, error,

Text of the page (most frequently used words):
video (275), and (245), image (204), transformations (169), sdk (142), upload (138), the (103), api (93), images (86), cloudinary (77), #transformation (72), reference (69), react (68), with (57), introduction (51), assets (51), javascript (47), media (46), player (45), next (43), node (43), sample (39), vue (39), for (38), start (38), asset (37), angular (37), management (36), quick (35), overview (33), php (32), optimization (32), add (30), product (30), conditional (29), python (29), advanced (27), videos (27), apis (26), flutter (26), configure (26), widget (25), optimize (24), 2026 (23), text (23), projects (22), delivery (22), your (21), 2023 (21), troubleshooting (21), crop (20), tutorials (20), account (20), effects (20), get (19), resize (19), 2024 (19), content (19), sdks (18), started (18), condition (18), dart (18), analysis (18), android (17), ios (17), streaming (17), detection (17), google (17), tips (17), metadata (16), native (16), gallery (16), accessibility (16), layer (16), you (15), svelte (15), net (15), ruby (15), rails (15), java (15), auto (15), audio (15), project (15), roles (15), step (15), legacy (14), moderation (14), background (14), tagging (14), user (14), programmatic (14), ons (13), this (13), from (13), 2025 (13), builder (13), custom (13), social (13), library (12), using (12), specifying (12), first (12), permissions (12), live (12), cropping (12), amazon (12), rekognition (12), color (12), modes (12), app (12), how (11), based (11), component (11), migration (11), guide (11), jquery (11), analyze (11), cli (11), automatic (11), remove (11), deliver (11), manage (11), search (11), onboarding (11), use (10), conditions (10), are (10), url (10), named (10), skills (10), beta (10), visual (10), delete (10), signatures (10), options (10), tags (9), if_end (9), agent (9), may (9), october (9), release (9), notes (9), laravel (9), uploads (9), guides (9), overlay (8), update (8), postman (8), collections (8), references (8), imagga (8), create (8), animated (8), special (8), layers (8), gravity (8), types (8), files (8), hints (8), resources (8), code (8), support (7), faq (7), products (7), try (7), error (7), when (7), settings (7), example (7), best (7), july (7), august (7), astro (7), kotlin (7), canvas (7), admin (7), removal (7), workflows (7), apps (7), presets (7), side (7), training (6), demos (6), page (6), additional (6), parameters (6), usage (6), scale (6), applied (6), format (6), syntax (6), mobile (6), integration (6), provisioning (6), creation (6), editor (6), generation (6), transcription (6), aware (6), customize (6), practices (6), console (6), list (6), public (6), type (6), uploading (6), crops (6), features (6), pdf (6), basics (6), dev (6), agents (6), documentation (5), pricing (5), more (5), can (5), that (5), disabled (5), contextual (5), structured (5), urls (5), both (5), only (5), before (5), tag (5), chained (5), generate (5), resizing (5), padding (5), defined (5), 2022 (5), january (5), february (5), april (5), frontend (5), studio (5), config (5), profiles (5), enhancement (5), extraction (5), duplicate (5), interactive (5), controls (5), profile (5), transform (5), data (5), moderate (5), client (5), analytics (5), adaptive (5), bitrate (5), extension (5), tools (5), load (5), find (5), credentials (5), all (4), policy (4), developers (4), retail (4), commerce (4), cloud (4), what (4), multiple (4), define (4), default (4), value (4), here (4), set (4), width (4), examples (4), checks (4), components (4), run (4), install (4), mcp (4), servers (4), june (4), september (4), november (4), starter (4), kit (4), access (4), why (4), sign (4), policies (4), assign (4), folder (4), pdfs (4), authentication (4), quality (4), failed (4), unsigned (4), formats (4), changelog (4), errors (4), recipes (4), variables (4), arithmetic (4), reshaping (4), artistic (4), enhancements (4), underlays (4), watermarking (4), transforming (4), fonts (4), placement (4), placing (4), trimming (4), flags (4), rollout (4), html (4), around (4), face (4), shape (4), restore (4), replace (4), fill (4), generative (4), zoompan (4), cards (4), backgrounds (4), drop (4), nuxt (4), pages (4), blog (3), events (3), getting (3), resource (3), non (3), dam (3), rate (3), feedback (3), email (3), was (3), learn (3), expressions (3), include (3), values (3), any (3), note (3), sale (3), than (3), square (3), has (3), key (3), duration (3), trim (3), including (3), logo (3), within (3), single (3), its (3), specified (3), without (3), always (3), setup (3), download (3), previous (3), releases (3), latest (3), drupal (3), netlify (3), gatsby (3), nuxtjs (3), community (3), developed (3), libraries (3), backend (3), claimable (3), webpurify (3), viesus (3), url2png (3), website (3), screenshots (3), pixelz (3), ocr (3), microsoft (3), azure (3), indexer (3), perception (3), point (3), malware (3), translation (3), vision (3), aspose (3), document (3), conversion (3), celebrity (3), facial (3), attributes (3), action (3), clarity (3), adaptability (3), accessible (3), buy (3), marketplace (3), review (3), picture (3), generated (3), differentiators (3), counted (3), billing (3), plans (3), environment (3), version (3), webhook (3), notifications (3), eager (3), incoming (3), crud (3), file (3), post (3), processing (3), customizing (3), menu (3), glossary (3), enterprise (3), service (3), café (3), sessions (3), español (3), youtube (3), fetch (3), tutorial (3), feature (3), congrats (3), ready (3), faster (3), register (3), developer (3), kickstart (3), starts (3), power (3), privacy (2), contact (2), customers (2), about (2), our (2), security (2), details (2), see (2), name (2), want (2), should (2), were (2), rating (2), exposed (2), context (2), adds (2), icon (2), stock (2), level (2), less (2), 200 (2), 300 (2), scaled (2), down (2), those (2), regardless (2), true (2), below (2), not (2), one (2), between (2), resulting (2), same (2), however (2), shown (2), above (2), if_condition (2), part (2), expression (2), coding (2), assistant (2), copy (2), prompt (2), dec (2), feb (2), apr (2), december (2), cloudinary_url_gen (2), package (2), active (2), storage (2), attachinary (2), carrierwave (2), object (2), mixing (2), contrast (2), temporary (2), ugc (2), multi (2), channel (2), bot (2), traffic (2), control (2), successfully (2), rotate (2), keys (2), did (2), spike (2), migrate (2), optimizer (2), downgrade (2), plan (2), recover (2), credit (2), card (2), payments (2), existing (2), cancel (2), system (2), via (2), migrating (2), saml (2), sso (2), high (2), adult (2), nsfw (2), permitted (2), naming (2), conventions (2), avoiding (2), already (2), fetched (2), underscores (2), ids (2), names (2), does (2), store (2), cookies (2), modify (2), original (2), dimensions (2), check (2), changed (2), issues (2), invalidate (2), cached (2), backups (2), provenance (2), authenticity (2), response (2), notification (2), inspector (2), semantic (2), rules (2), cacheable (2), method (2), relate (2), rename (2), filemaker (2), cloud_name (2), uploaded (2), truncated (2), unsupported (2), requests (2), rejected (2), script (2), codec (2), missing (2), play (2), simulated (2), poster (2), frame (2), watermark (2), white (2), looping (2), gif (2), converting (2), previews (2), posters (2), rotating (2), playback (2), transition (2), concatenation (2), concatenating (2), transcoding (2), shoppable (2), ads (2), monetization (2), hls (2), mpeg (2), dash (2), playlists (2), recommendations (2), customization (2), embed (2), installation (2), blurry (2), force (2), specific (2), sharing (2), links (2), facebook (2), detect (2), corrupted (2), placeholder (2), lqip (2), long (2), time (2), byte (2), ttfb (2), webpagetest (2), org (2), delivered (2), gzip (2), compression (2), title (2), archives (2), cdn (2), methods (2), photoshop (2), pictures (2), remote (2), core (2), frameworks (2), dynamic (2), responsive (2), offset (2), position (2), solid (2), over (2), instagram (2), story (2), photo (2), percentage (2), horizontal (2), line (2), person (2), full (2), body (2), functions (2), models (2), refiners (2), focus (2), areas (2), recolor (2), cutouts (2), distortion (2), displacement (2), rotation (2), rounding (2), distorting (2), vertical (2), collage (2), layouts (2), upscaling (2), downscaling (2), shadows (2), effect (2), splice (2), complex (2), watermarks (2), convert (2), overlays (2), enhance (2), abr (2), diagnosing (2), codes (2), solidjs (2), widgets (2), scripting (2), django (2), captioning (2), fallbacks (2), sanity (2), lazy (2), signature (2), interaction (2), webhooks (2), hono (2), remix (2), sveltekit (2), server (2), actions (2), drag (2), captions (2), programmatically (2), edits (2), secret (2), free (2), powered (2), brand (2), capabilities (2), tech (2), stack (2), platforms (2), integrations (2), easyflows (2), powerflows (2), mediaflows (2), index (2), theme (2), docs (2), 697, rights, reserved, dmca, notice, terms, education, sales, technical, trust, newsroom, careers, partners, company, profits, travel, hospitality, entertainment, solutions, programmable, again, unfortunately, there, been, sending, assistance, open, request, committed, protecting, information, send, back, improved, good, looking, thanks, submitting, got, love, hear, tell, liked, make, even, better, helpful, doc, sent, combine, logic, fallback, else, branches, characteristics, operators, related, topics, variable, their, publicly, prevent, such, being, disable, option, enabled, setting, exposes, will, return, ctx, determined, numeric, field, external, strings, in_stock, among, assigned, resizes, producttype, shoes, limits, size, pixels, mode, then, uses, caption, whose, initial, wider, if_iw_gt_300, limit, also, includes, beginning, after, end, false, result, whether, case, apply, entire, evaluated, location, cannot, placed, supported, must, if_w_eq_h, t_trans, some, require, separation, automatically, technically, defining, inside, need, closing, avoid, ambiguity, practice, following, 500px, afterwards, identical, padded, since, applies, portrait, aspect, ratio, parrot, if_ar_lt_1, b_darkorange, c_pad, h_300, w_500, covers, structure, worked, embeds, directly, call, aren, separately, themselves, last, updated, jun, view, repo, github, give, class, working, paste, into, sets, installs, configures, validates, markdown, llm, discover, available, exploring, further, complete, https, com, llms, txt, device, dark, light, ask, toggle, navigation, them, now, important, new, plus, keep, current, applying,

Text of the page (random words):
nsformations for a condition advanced conditional transformations user defined variables and arithmetic transformations video transformation recipes white background looping gif add a logo or watermark to a video resize a video for social media create a poster image from a video frame video and audio optimization video optimization adaptive bitrate streaming audio optimization video transcription ai video analysis ai video analysis api reference video analytics live streaming live streaming api reference simulated live streaming video add ons video best practices social media videos troubleshooting and tips troubleshooting video transformation errors video duration missing on first play remove codec from content type upload uploading assets customizing uploads post upload processing client side uploading upload presets upload widget upload widget changelog troubleshooting and tips unsigned upload from google apps script rejected file formats troubleshooting failed upload requests always upload a square image unsupported parameters in unsigned uploads uploaded image truncated upload failed cloud_name is disabled error upload with filemaker asset management crud asset management apis list assets update assets delete assets rename assets relate assets media library for developers search for assets search api method cacheable search urls visual search search expressions eager and incoming transformations custom metadata tags contextual metadata structured metadata conditional metadata rules analyze assets image quality analysis accessibility analysis semantic data extraction media inspector analyze api beta moderate assets webhook notifications advanced asset management signatures authentication signatures notification signatures delivery url signatures response signatures provenance and authenticity backups and version management invalidate cached assets add ons troubleshooting and tips admin api authentication issues why has the public id of my asset changed asset id vs public id check resource type and delivery type get image or video dimensions download account assets delete or modify original images does cloudinary store any cookies underscores in public ids or folder names update already fetched asset upload manage and deliver pdfs cloudinary sample images avoiding duplicate uploads permitted naming conventions adult nsfw content policy high transformation rate account management account settings folder modes product environment settings user provisioning saml sso billing and plans roles and permissions migrating to roles and permissions legacy permissions manage assign roles in the console roles and permissions via api manage roles assign roles define custom policies system roles and policies list usage data how are transformations counted troubleshooting and tips cancel or delete cloudinary account sign up or add user with existing email credit card payments recover disabled account can t downgrade my plan migrate media optimizer account why did my usage spike rotate api keys in the console successfully go live with cloudinary bot traffic and access control retail and e commerce best practices visual differentiators customize and optimize assets workflows product asset workflows non product asset workflows multi channel content delivery user generated content overview upload manage and analyze transform and customize optimize and deliver profile picture sample project video review sample project marketplace products sample project try before you buy sample project delete temporary ugc assets accessible media overview image accessibility video and audio accessibility image and video adaptability visual and audio clarity color accessibility text contrast and color audio controls and mixing interactive content and controls ai in action native mobile add ons advanced facial attributes detection amazon rekognition ai moderation amazon rekognition video moderation amazon rekognition auto tagging amazon rekognition celebrity detection aspose document conversion cloudinary ai background removal cloudinary ai content analysis overview object aware cropping automatic image tagging image analysis cloudinary ai vision cloudinary duplicate image detection cloudinary image generation google ai video moderation google ai video transcription google auto tagging google automatic video tagging google translation image to video image to video api reference imagga auto tagging imagga crop and scale perception point malware detection microsoft azure video indexer ocr text detection and extraction pixelz remove the background url2png website screenshots viesus automatic image enhancement webpurify image moderation references transformation url api upload api admin api cloudinary cli image apis analyze api beta image generation api video apis ai video analysis api beta image to video api live streaming api player profiles api video canvas api video config api video player api widget apis media editor api media library widget api product gallery api studio widget api upload widget api account management apis agent account creation api claimable cloud api permissions api provisioning api sdk references angular sdk reference dart sdk reference flutter sdk reference go sdk reference javascript sdk reference php sdk reference react sdk reference transformation builder reference vue js sdk reference postman collections sdks backend sdks node js sdk node js introduction node js quick start node js image and video upload node js image transformations node js video transformations node js asset management node js sample projects node js video tutorials python sdk python introduction python quick start python image and video upload python image transformations python video transformations python asset management python sample projects python video tutorials php sdk php introduction php quick start php image and video upload php image transformations php video transformations php asset management php sample projects php video tutorials php management reference php transformation reference java sdk java introduction java quick start java image and video upload java image transformations java video transformations java asset management ruby rails sdk ruby rails introduction ruby rails quick start ruby rails image and video upload ruby rails image transformations ruby rails video transformations ruby rails asset management carrierwave integration attachinary integration active storage integration net sdk net introduction net quick start net image and video upload net image transformations net video transformations net asset management go sdk go introduction go quick start go image and video upload go media transformations go asset management go sample projects go video tutorials go sdk reference dart sdk dart introduction dart quick start dart image and video upload dart media transformations dart sdk reference frontend sdks react sdk react introduction react starter kit react quick start react image and video upload react image transformations react video transformations react sample projects react video tutorials react sdk reference transformation builder reference vue js sdk vue js introduction vue js quick start vue js image and video upload vue js image transformations vue js video transformations vue js sample projects vue js video tutorials vue js sdk reference transformation builder reference angular sdk angular introduction angular quick start angular image and video upload angular image transformations angular video transformations angular sample projects angular video tutorials angular sdk reference transformation builder reference javascript sdk javascript introduction javascript quick start javascript image and video upload javascript image transformations javascript video transformations javascript sample projects javascript video tutorials javascript sdk reference transformation builder reference next js sdk next js introduction next js starter kit next js quick start next js image and video upload next js image transformations next js video transformations next js sample projects next js video tutorials jquery sdk jquery introduction jquery image and video upload jquery image transformations jquery video transformations react sdk legacy react introduction react image and video upload react image transformations react video transformations react migration guide vue js sdk legacy vue js introduction vue js image and video upload vue js image transformations vue js video transformations vue js migration guide angular sdk legacy angular introduction angular image and video upload angular image transformations angular video transformations angular migration guide javascript sdk legacy javascript introduction javascript image and video upload javascript image transformations javascript video transformations javascript migration guide mobile sdks ios sdk ios introduction ios quick start ios image and video upload ios image transformations ios video transformations ios video player ios sample projects android sdk android introduction android quick start android image and video upload android image transformations android video transformations android video player android sample projects flutter sdk flutter introduction flutter quick start flutter image and video upload flutter media transformations flutter video player flutter video tutorials dart based cloudinary_url_gen package reference flutter sdk reference react native sdk react native introduction react native image and video upload react native image transformations react native video transformations react native video player kotlin sdk kotlin introduction kotlin media transformations community developed libraries astro laravel nuxtjs svelte gatsby netlify drupal release notes latest october 31 2026 august 31 2026 july 9 2026 previous releases may 28 2026 april 7 2026 february 28 2026 january 30 2026 2025 december 18 2025 october 31 2025 september 3 2025 july 09 2025 may 27 2025 2024 november 29 2024 october 9 2024 august 12 2024 june 27 2024 may 31 2024 april 16 2024 february 28 2024 january 03 2024 2023 november 13 2023 october 26 2023 september 21 2023 august 15 2023 july 13 2023 june 19 2023 may 16 2023 apr 04 2023 feb 21 2023 2022 dec 27 2022 image video apis cloudinary video video transformations advanced video transformations conditional transformations specifying transformations for a condition specifying transformations for a condition copy for llm download markdown get started get started with cloudinary paste one prompt into your ai coding assistant and it sets up cloudinary for you installs the sdk configures skills and mcp servers and validates your setup copy prompt learn more agent skills install cloudinary agent skills cloudinary agent skills give your ai coding assistant first class context for working with cloudinary run to install or update the skills view the skills repo on github learn about cloudinary skills last updated jun 09 2026 a conditional transformation embeds a transformation directly within a condition in your url or sdk call using the format if_condition transformation if_end the condition and its transformation are part of the same expression and aren t defined separately for details on the conditions themselves see specifying conditions this page covers how to structure the transformation part of the expression including chained transformations with worked examples on this page conditional transformation syntax conditional transformation examples conditional transformation syntax the transformation for a condition should be specified between the condition component and an if_end component in the format if_condition transformation if_end for example if_ar_lt_1 0 b_darkorange c_pad h_300 w_500 if_end in the following examples both videos are scaled to a width of 500px afterwards the identical conditional padded resize transformation shown above is applied to both videos however since the condition applies only for portrait videos those with an aspect ratio less than 1 0 the resizing and padding is applied only to the parrot video below note transformation urls technically support defining both the condition and a single resulting transformation inside a single transformation component without the need for a closing if_end however to avoid ambiguity the best practice is to always use if and if_end components in your url as shown above some sdks require this separation and automatically generate urls in the if if_end format a named transformation cannot be placed in the same transformation component as its condition e g if_w_eq_h t_trans is not supported and must be specified using the if if_end format if you do include both the if condition and the resulting transformation parameters within a single component of the url the if condition is evaluated first regardless of its location within the component and only when the condition is true all transformation parameters specified in that component are applied conditions with chained transformations you can apply multiple chained transformations to your condition by including the entire chained transformation in between the if and if_end components the example below checks whether the video asset s tags include a cloudinary tag only in that case a chained transformation including an image overlay cloudinary logo and a text overlay by cloudinary are applied if cloudinary is not one of the tags no image or text overlay is applied note that this example also includes a scale down transformation before the beginning of the conditional transformation and a duration trim after the end of the conditional transformation those transformations are applied regardless of the true or false result of the condition conditional transformation examples conditional text overlay based on width this example limits a video size to a width of 300 pixels using the limit crop mode and then uses a conditional transformation to add a text caption only to videos whose initial width was wider than 300 and were scaled down if_iw_gt_300 conditional resize based on a contextual metadata value this example resizes a video to a 200 200 square video if it has a contextual metadata key named producttype with the value shoes conditional image overlay based on tags this example adds a sale icon to a product video if both the strings sale and in_stock are among the tags assigned to the video conditional image overlay based on structured metadata value this example adds a sale icon to a product video if the stock level of the product is less than 50 as determined by the value of the numeric structured metadata field with external id stock level here set as 30 note when you use variable or conditional expressions that include the tags ctx or md parameters their values are exposed publicly in the url if you want to prevent such values from being exposed you can disable the usage of tags context metadata in transformation urls option in the s...