
Cloudinary overlay URLs have two syntax boundaries that can change what gets resized. Use colons for slashes inside an overlay public ID, then close the overlay with fl_layer_apply. Transformation components before that closing flag belong to the open layer, rather than automatically returning to the base photograph.
Key Takeaways
- The base asset and overlay public ID use different path notation.
- An open layer keeps receiving chained transformations until it is closed.
- Placement qualifiers belong with the layer-apply component.
Mark the layer opening and closing
Cloudinary's layer-syntax guide says an overlay such as public ID brand/logo is referenced as l_brand:logo. The base asset's ordinary delivery path does not get the same slash-to-colon conversion.
The layer-transformation reference explains that chained transformations apply to the last added overlay or underlay until a component contains fl_layer_apply. Treat the opening and closing as brackets while reading the URL.
Build an annotated candidate
For a hypothetical non-sensitive sample, the chain:
c_scale,w_800/l_brand:logo/c_scale,w_120/fl_layer_apply,g_north_east
means resize the base, open the logo layer, resize the logo, then place and close it. The example assumes that the named sample assets exist in your own environment; it is not a working public delivery address.
- Write the intended base dimensions and logo dimensions separately.
- Identify the overlay's actual public ID, including any folder-like segments.
- Convert only its overlay-reference slashes to colons.
- Place the logo's resizing components after the layer opening.
- Close with
fl_layer_apply, adding the intended placement qualifiers. - Inspect the returned base dimensions, logo size and position.
If a resize unexpectedly shrinks the logo, look for an unclosed layer before adding another resize elsewhere.
Compare two different failure signatures
A malformed overlay reference can prevent the logo being found. An open-layer scope error can produce a valid image with the wrong element resized. Those are different problems, even though both appear after adding a logo.
For nested overlays, each layer needs its own closing component, and the inner layer must close first. Reduce a complicated chain to one overlay while diagnosing scope; restore additional layers only after that candidate is understood.
Accept the actual composition
Open the delivered file independently and compare it at target display size. Confirm the base canvas, logo identity, readable lettering and intended corner clearance. A syntactically valid URL does not establish that a watermark is visually appropriate or prevents copying.
The mixed-crop watermark guide covers visual placement review. This guide addresses the different URL-parser contract that determines which asset receives each operation. Private or authenticated overlays also require whole-URL signing under Cloudinary's documented rules.
Related tasks
- Keep a Lightroom Watermark Readable Across Different Crops
- Why Is My Website Slow After I Upload Full-Size AI Images Everywhere?
Sources and scope
- Cloudinary: Layer syntax: Overlay public IDs replace slash separators with colons; layer and layer_apply delimit the overlay; private/authenticated layers require whole-URL signing.
- Cloudinary: Transforming layers: Chained operations before layer_apply target the last open layer; placement at closing; nested closing order; relative sizing to overlay, base or detected region.
Documentation-based editorial guidance. All scenarios, worksheets and acceptance checks are hypothetical or proposed. No hands-on test, account operation, benchmark, measured search demand, AI-citation rate or platform acceptance is claimed.
Prepared by Imagild Editorial, the company editorial team responsible for these guides. AI assisted research and drafting. This is documentation-based guidance with proposed examples, not a claim of hands-on testing or an independent product review. Report a correction.
Cover: AI-generated conceptual editorial illustration; not a real application screenshot, observed output or before-and-after test.