rule

Request rule element. One or more are optional in the <ruleset> element.

Attributes

OnMatch="break"|"continue"|"error" Optional. Default is “break”.

Name=" *text*" Optional. Used to identify the <rule> element in debug logs and error messages.

In addition, <rule> elements may define any of the following attributes in any combination. If specified, and the rule is successfully matched, they override the corresponding catalog attributes for this request.

<rule> attribute

Corresponding Image Catalog attribute

DefaultPix

attribute::DefautPix

ErrorImage

attribute::ErrorImage

Expiration

attribute::Expiration

MaxPix

attribute::MaxPix

RootUrl

attribute::RootUrl

Refer to the description of the corresponding image catalog attribute for details.

The Expiration attribute only overrides the default attribute value; it is ignored if a specific catalog::Expiration value applies to the request.

Data

<expression>

Optional.

<substitution>

Optional.

<addressfilter>

Optional.

Notes

If both <expression> and <substitution> are specified, and captured substrings are not used, the first matched sub-string is replaced with <substitution>.

If <expression> is not specified, any path will match and <substitution> is appended to the end of the path.

If <substitution> is not specified, the matched substring is removed.

The <addressfilter> is applied only when a match occurs, and before query rules are applied.

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now