Meta tags:
description=Learn how to upload files with only a few lines of Node.js code, including cloud storage, CDN delivery, and dynamic effects for images and media.;

Headings (most frequently used words):

node, js, get, configuration, quick, example, sdk, started, cloudinary, install, configure, sample, set, parameters, documentation, index, with, agent, skills, how, would, you, like, to, learn, use, projects, required, additional, video, tutorials, file, upload, transform, and, optimize, details, of, single, asset, error, response, find, your, credentials, the, in,

Text of the page (most frequently used words):
and (283), video (275), image (219), transformations (163), sdk (161), #upload (157), the (139), api (104), cloudinary (92), images (90), node (77), reference (71), react (68), with (63), assets (62), transformation (52), introduction (52), your (49), media (48), sample (47), javascript (47), for (46), player (45), next (43), quick (41), start (41), asset (40), management (39), vue (39), angular (37), overview (34), optimization (34), you (32), php (32), add (31), configure (31), apis (29), product (29), python (29), videos (27), projects (27), optimize (27), flutter (26), get (25), advanced (25), tutorials (25), widget (25), delivery (24), 2026 (23), using (23), started (22), code (22), sdks (21), from (21), crop (21), effects (21), 2023 (21), troubleshooting (21), account (20), use (19), 2024 (19), text (19), content (19), can (18), detection (18), dart (18), analysis (18), android (17), ios (17), streaming (17), google (17), tips (17), resize (17), library (16), more (16), native (16), gallery (16), accessibility (16), layer (16), example (15), svelte (15), net (15), ruby (15), rails (15), java (15), auto (15), audio (15), project (15), roles (15), step (15), see (14), guide (14), 2025 (14), legacy (14), moderation (14), background (14), tagging (14), user (14), programmatic (14), ons (13), how (13), manage (13), deliver (13), builder (13), custom (13), social (13), this (12), learn (12), admin (12), analyze (12), search (12), environment (12), permissions (12), live (12), cropping (12), amazon (12), rekognition (12), color (12), modes (12), app (12), metadata (11), visual (11), options (11), uploads (11), delete (11), first (11), migration (11), jquery (11), cli (11), automatic (11), remove (11), onboarding (11), release (10), notes (10), guides (10), files (10), skills (10), beta (10), signatures (10), conditional (10), all (9), about (9), try (9), uploading (9), references (9), url (9), transform (9), gravity (9), set (9), install (9), configuration (9), parameters (9), resources (9), agent (9), may (9), october (9), laravel (9), apps (8), method (8), presets (8), data (8), config (8), update (8), postman (8), collections (8), imagga (8), create (8), specifying (8), animated (8), special (8), layers (8), types (8), named (8), hints (8), faq (7), products (7), page (7), additional (7), following (7), public (7), when (7), type (7), list (7), find (7), credentials (7), generation (7), version (7), console (7), settings (7), integration (7), features (7), july (7), august (7), astro (7), kotlin (7), canvas (7), removal (7), workflows (7), side (7), training (6), support (6), documentation (6), demos (6), error (6), cloud (6), check (6), capabilities (6), examples (6), that (6), tag (6), format (6), scale (6), file (6), transforming (6), moderate (6), usage (6), variable (6), based (6), mobile (6), provisioning (6), creation (6), editor (6), transcription (6), aware (6), customize (6), best (6), practices (6), crops (6), pdf (6), basics (6), dev (6), agents (6), policy (5), developers (5), resource (5), pricing (5), backend (5), details (5), generated (5), quality (5), overlay (5), face (5), before (5), formats (5), policies (5), generate (5), defined (5), replace (5), syntax (5), run (5), changelog (5), june (5), 2022 (5), january (5), february (5), april (5), frontend (5), studio (5), profiles (5), enhancement (5), extraction (5), duplicate (5), interactive (5), controls (5), profile (5), client (5), analytics (5), adaptive (5), bitrate (5), extension (5), tools (5), load (5), blog (4), getting (4), our (4), retail (4), commerce (4), security (4), name (4), what (4), out (4), tags (4), different (4), here (4), uploaded (4), logo (4), original (4), methods (4), customizing (4), existing (4), any (4), setup (4), default (4), urls (4), required (4), define (4), secret (4), cloud_name (4), previous (4), latest (4), mcp (4), servers (4), september (4), november (4), starter (4), kit (4), access (4), why (4), disabled (4), sign (4), assign (4), folder (4), pdfs (4), authentication (4), failed (4), unsigned (4), errors (4), recipes (4), variables (4), arithmetic (4), condition (4), conditions (4), reshaping (4), artistic (4), enhancements (4), underlays (4), watermarking (4), fonts (4), placement (4), placing (4), trimming (4), resizing (4), flags (4), rollout (4), html (4), around (4), shape (4), padding (4), restore (4), fill (4), generative (4), zoompan (4), cards (4), backgrounds (4), drop (4), nuxt (4), component (4), pages (4), events (3), non (3), dam (3), rate (3), feedback (3), email (3), was (3), docs (3), response (3), automatically (3), convert (3), without (3), rotate (3), offset (3), effect (3), simple (3), explore (3), available (3), notification (3), rename (3), versions (3), overlays (3), own (3), naming (3), conventions (3), include (3), note (3), key (3), control (3), system (3), important (3), through (3), already (3), copy (3), keys (3), signature (3), package (3), free (3), installation (3), download (3), releases (3), drupal (3), netlify (3), gatsby (3), nuxtjs (3), community (3), developed (3), libraries (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), differentiators (3), are (3), counted (3), billing (3), plans (3), webhook (3), notifications (3), eager (3), incoming (3), crud (3), post (3), processing (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), checks (3), privacy (2), contact (2), customers (2), open (2), should (2), rating (2), helpful (2), tip (2), take (2), look (2), help (2), into (2), application (2), managing (2), read (2), included (2), jpg (2), including (2), pixel (2), my_dog (2), them (2), not (2), only (2), parameter (2), don (2), relevant (2), writing (2), expose (2), alternatively (2), api_secret (2), api_key (2), such (2), cloudinary_url (2), either (2), shown (2), these (2), classes (2), source (2), would (2), like (2), new (2), github (2), repo (2), implement (2), coding (2), assistant (2), prompt (2), dec (2), feb (2), apr (2), december (2), cloudinary_url_gen (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), successfully (2), did (2), spike (2), migrate (2), optimizer (2), downgrade (2), plan (2), recover (2), credit (2), card (2), payments (2), cancel (2), via (2), migrating (2), saml (2), sso (2), high (2), adult (2), nsfw (2), permitted (2), avoiding (2), fetched (2), underscores (2), ids (2), names (2), does (2), store (2), cookies (2), modify (2), dimensions (2), has (2), changed (2), issues (2), invalidate (2), cached (2), backups (2), provenance (2), authenticity (2), inspector (2), semantic (2), rules (2), structured (2), contextual (2), expressions (2), cacheable (2), relate (2), filemaker (2), truncated (2), unsupported (2), always (2), square (2), requests (2), rejected (2), script (2), codec (2), duration (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), 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), photoshop (2), pictures (2), remote (2), core (2), frameworks (2), dynamic (2), responsive (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), splice (2), trim (2), components (2), complex (2), watermarks (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), interaction (2), webhooks (2), hono (2), remix (2), sveltekit (2), server (2), actions (2), drag (2), multiple (2), captions (2), programmatically (2), edits (2), powered (2), brand (2), tech (2), stack (2), platforms (2), integrations (2), easyflows (2), powerflows (2), mediaflows (2), index (2), theme (2), 783, 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, request, committed, protecting, information, send, want, back, improved, good, were, looking, thanks, submitting, got, love, hear, tell, liked, make, even, better, doc, sent, stay, tuned, updates, renaming, deleting, adding, searching, powerful, related, topics, collection, too, integrating, select, tab, snippets, uses, return, cld, single, possible, ways, similar, way, above, png, originally, reduce, size, impacting, resulting, degrees, southeast, corner, slight, down, width, increased, brightness, partial, transparency, opacity, apply, sepia, radius, round, corners, 150x150, thumbnail, determine, location, relatively, performs, delivering, front_face, delivers, public_id, overwrites, exists, finishes, specified, receives, dog, mp4, capitalization, guidelines, organize, keeping, intact, sizes, customized, needs, optimizing, overwrite, much, once, installed, configured, appended, query, tracks, aggregated, improve, future, collect, individual, needed, disable, option, urlanalytics, append, secure_distribution, upload_prefix, addition, number, optional, need, aren, involves, exclude, publicly, dotenv, applications, follow, organization, storing, secrets, paas, heroku, deployment, actual, values, correctly, your_api_secret, your_api_key, throughout, avoid, confusion, calls, omit, within, module, es6, import, statement, recommended, follows, supported, npm, other, online, course, where, digital, changlog, link, fixes, functionality, watch, cases, analyzing, running, five, minutes, walk, description, recently, released, enhanced, improves, validation, handling, input, recommend, upgrading, benefit, improvements, upgrade, provides, yet, comprehensive, integrates, seamlessly, last, updated, nov, view, give, class, context, working, paste, one, sets, installs, configures, validates, markdown, llm, discover, exploring, further, complete, https, com, llms, txt, device, dark, light, ask, toggle, navigation, now, plus, keep, current,

Text of the page (random words):
count 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 sdks backend sdks node js sdk node js sdk 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 nov 04 2026 the cloudinary node js sdk provides simple yet comprehensive image and video upload transformation optimization and delivery capabilities through the cloudinary apis that you can implement using code that integrates seamlessly with your existing node js application sdk security upgrade june 2025 we recently released an enhanced security version of this sdk that improves the validation and handling of input parameters we recommend upgrading to the latest version of the sdk to benefit from these security improvements how would you like to learn resource description node js quick start get up and running in five minutes with a walk through of installation configuration upload management and transformations video tutorials watch tutorials relevant to your use cases from getting started with the node js sdk to uploading transforming and analyzing your images and videos sample projects explore sample projects to see how to implement cloudinary functionality such as upload and delivery with transformations cloudinary node js sdk github repo explore the source code and see the changelog changlog link for details on all new features and fixes from previous versions try the free introduction to cloudinary for node js developers online course where you can learn how to upload manage transform and optimize your digital assets other helpful resources on this page how would you like to learn install configure use sample projects install cloudinary s node js integration library is available as an open source npm package to install the library run note check that you re using a supported version of node js configure include cloudinary s node js classes in your code important the node js sdk upload and admin method syntax examples shown throughout this documentation use the v2 signature to avoid confusion all code examples use the format cloudinary v2 in your own code it s recommended to include v2 of the node js classes as follows alternatively from within a module you can use an es6 import statement following either of these your upload and admin api calls should omit the v2 shown in the code examples of this guide for example a simple image upload set required configuration parameters you can set the required configuration parameters cloud_name api_key and api_secret either using the cloudinary_url environment variable or using the config method in your code to define the cloudinary_url environment variable copy the api environment variable format from the api keys page of the cloudinary console settings replace your_api_key and your_api_secret with your actual values your cloud name is already correctly included in the format for example note when using cloudinary through a paas add on such as heroku this environment variable is automatically defined in your deployment environment alternatively you can use the config method to set your cloud_name api_key and api_secret for example important when writing your own applications follow your organization s policy on storing secrets and don t expose your api secret if you use a method that involves writing your environment variable to a file e g dotenv exclude the file from your version control system so as not to expose it publicly tip to generate transformation urls you only need to configure the cloud name the api key and api secret aren t required for url generation set additional configuration parameters in addition to the required configuration parameters you can define a number of optional configuration parameters if relevant you can append configuration parameters for example upload_prefix and secure_distribution to the environment variable or you can use the config method in your code for example note by default urls generated with this sdk include an appended sdk usage query parameter cloudinary tracks aggregated data from this parameter to improve future sdk versions we don t collect any individual data if needed you can disable the urlanalytics configuration option learn more configuration video tutorials the following tutorials can help you install and set up your sdk find your credentials find your cloudinary credentials for apis and sdks configure the node js sdk install and configure the cloudinary node js sdk get started in node js get started with cloudinary in node js including setup and image optimization see more node js video tutorials use once you ve installed and configured the node js sdk you can use it for uploading files to your product environment you can upload any files not only images and videos set your own naming conventions and overwrite policies moderate and tag your assets on upload and much more see example transforming and optimizing images and videos keeping your original assets intact in your product environment you can deliver different versions of your media different sizes formats with effects and overlays customized for your needs see example managing assets using methods from the admin and upload apis you can organize your assets for example list rename and delete them add tags and metadata and use advanced search capabilities see example capitalization and data type guidelines quick example file upload the following node js code uploads the dog mp4 video using the public_id my_dog the video overwrites the existing my_dog video if it exists when the video upload finishes the specified notification url receives details about the uploaded media asset learn more about upload read the upload guide to learn more about customizing uploads using upload presets and more see more examples of image and video upload using the cloudinary node js library explore the upload api reference to see all available methods and options quick example transform and optimize take a look at the following transformation code and the image it delivers this relatively simple code performs all of the following on the original front_face jpg image before delivering it crop to a 150x150 thumbnail using face detection gravity to automatically determine the location for the crop round the corners with a 20 pixel radius apply a sepia effect overlay the cloudinary logo on the southeast corner of the image with a slight offset scale the logo overlay down to a 50 pixel width with ...