There are two main ways to customize asset share links and embed codes: through the DAM user interface and by manually adjusting HTML.
Customizing in DAM
With permission, users can create customized asset share links and embed codes, beyond the presets and size options available in the DAM. In classic search results, Quick View, or Asset Details page, click the Share button for a single asset.
Choose either link or embed code, then in the size dropdown, select Create Your Own.
You see size options, including the original size and fixed width and height, which you can adjust. If you select fixed width or fixed height, the image will scale to maintain aspect ratio. The maximum width and height for images is 2,048 x 2,048 px.
Select an anchor location for the image and rotate the image. You can also change the image background by clicking Display. Select a color or, to retain the transparent background on an asset, move the slider all the way to the left.
Under Advanced, you can choose to save the image as a specific format, then select image quality. If the image should be delivered over a secure connection, check Use a secure connection. To display the image in a high-pixel density, check Retina display. If you'd like others to be able to download the original format of the image, check Show download button.
After your customizations are complete, copy the code. You can also click Save preset to set it as a pre-determined sizesfor other DAM users to select.
Customizing manually
For images, share links and embed codescan be customized by manually changing the dimensions, cropping (the keep area), or background color. Here's an example of an embed code:
The order of the parameters in the URL before the question mark cannot be changed. However, all parameters after the question mark can be ordered in any way.
Image size
To specify an exact image size, provide both the width (width= or w=) and the height (height= or h=). To specify the size of a landscape image and preserve its aspect ratio, specify only the width. Likewise, for a portrait image, specify only the height. If you don't specify either width or height, the Acquia DAM will provide you with an image based on the original asset size, up to a maximum of 2,048 pixels in the longest dimension.
If you specify the retina parameter (&retina=true), the pixel size that's returned will be doubled. For example, if you request w=300 and h=200, the DAM will return an image with a pixel size 600x400. This is typically used to display with high pixel density.
Filename
The filename, while not required in a share link or embed code, is recommended for search engine optimization purposes. You can change or remove the filename and it will have no effect on the link path or the asset in DAM.
Image format
The image format can be GIF, JPEG, PNG, WEB, or WEBP. GIF or PNG formats are best for logo and line art images. If it's important to retain transparency in your embed codes, use the PNG format. If transparency isn't important but a smaller file size is, use the JPEG or WEBP format. If you don't have a preference, use the WEB format, which is a smart format that allows the DAM to pick the most appropriate format based on the characteristics of the asset.
This table illustrates the formats listed above and corresponding content that's included in the share link or embed code.
Format
Code content
GIF
image/gif
JPEG
image/jpeg
PNG
image/png
WEB
image/jpeg*, image/png*, image/webp*
WEBP
image/webp
*Returned image depends on the format of the asset.
Options
Options are specified as URL query parameters. Immediately after the image format, add a question mark ( ? ). Additional options are separated by the ampersand ( & ). An equals ( = ) sign is used to separate the option name from the option's value.
Quality
Name: quality or "q" Default: 80 Value: Integer from 0 (lowest quality) to 100 (highest quality) *For JPEG images only
Name: DPI or “dpi” Default: 72
The quality parameter determines image file size compression, whereas DPI determines the number of ink dots on a printed image. If this DPI parameter is not set in the customized embed code, the image's physical resolution is unspecified. Some formats like WEBP don’t require DPI, whereas some do, such as JPEG. For image formats that require it, if no DPI is set, these images will be given a default DPI of 72.
Embed code for a video without a player
For video embeds without a player, HD or SD quality parameters can be specified. The following are examples for each option:
For video embeds with an integrated player, specifying quality is unnecessary. The player automatically optimizes the quality based on network conditions and display size.
Name: crop Default: True Value: Boolean value. "true," "yes," or "y" for true. "false," "no," or "n" for false.
Crop area values are valid when you specify the image width and height. When true, the image is cropped to fit the aspect ratio of the requested size. When false, the image is created with an additional background area.
Keep area
Name: keep or "k"
Default: center
Value:
"c" = center "n" = north "ne" = northeast "e" = east "se" = southeast "s" = south "sw" = southwest "w" = west "nw" = northwest "smart" = AI-powered focal point detection
When you set the crop value to true, the primary area preserved is controlled by the keep value.
Smart crop
Smart crop uses AI-powered focal point detection to identify the visual subject of an image and crop to the requested dimensions relative to that point. You do not need to specify a fixed direction.
Prerequisite:
An administrator must enable the Smart crop toggle at /admin/features (under Manage Assets, labeled as AI) before you can use this parameter.
Availability: Smart crop is available for image assets only.
Syntax:
Add keep=smart to your embed link URL along with crop=true and the target dimensions.
This returns a 1500x1500 pixel image cropped around the detected focal point of the image.
Example: 1500x1500 crop comparison
The following images demonstrate how smart crop compares to center crop on a cherry blossom photograph.
Original image: Original cherry blossom tree against blue sky - full composition, no crop applied
keep=c (center crop):
1500x1500 center crop - anchors to the center of the image, resulting in the blossoms being partially cut off with mostly sky and black letterboxing visible
keep=smart (smart crop):
1500x1500 smart crop - detects the blossoms as the focal point, preserving better balance of subject and background
Comparison with fixed-anchor cropping:
Parameter
Behavior
keep=c
Preserves the center of the image regardless of subject position
keep=n
Preserves the top (north) area of the image
keep=smart
Detects the visual focal point and preserves the area around it
When smart crop is most effective:
Photographs with a clear subject, such as portraits, product shots, or wildlife
Hero banners and thumbnails from a mixed-composition library
Content where subject position varies across assets
Where results may vary:
Abstract images without a clear focal point
Graphic design compositions with evenly distributed elements
Infographics and text-heavy images
Low-contrast images where subject and background are similar
Notes:
You must set crop=true (or crop=yes) alongside keep=smart.
If the Smart crop toggle is not enabled on your site, the keep=smart parameter is ignored.
Smart crop does not support manual focal point overrides.
Smart crop does not apply to video or non-image assets.
Background color
Name: color or "co" Default: ffffff (white) Value: RGB color value specified as in HEX format
When you set the crop option to false, additional background areas are created with the specified color. Example HTML color codes are available.
Video autoplay
To configure autoplay in embed codes for videos with a player, add this: t.autoplay=true&t.muted=true
For example, the video embed code would look like:
There are two main ways to customize asset share links and embed codes: through the DAM user interface and by manually adjusting HTML.
Customizing in DAM
With permission, users can create customized asset share links and embed codes, beyond the presets and size options available in the DAM. In classic search results, Quick View, or Asset Details page, click the Share button for a single asset.
Choose either link or embed code, then in the size dropdown, select Create Your Own.
You see size options, including the original size and fixed width and height, which you can adjust. If you select fixed width or fixed height, the image will scale to maintain aspect ratio. The maximum width and height for images is 2,048 x 2,048 px.
Select an anchor location for the image and rotate the image. You can also change the image background by clicking Display. Select a color or, to retain the transparent background on an asset, move the slider all the way to the left.
Under Advanced, you can choose to save the image as a specific format, then select image quality. If the image should be delivered over a secure connection, check Use a secure connection. To display the image in a high-pixel density, check Retina display. If you'd like others to be able to download the original format of the image, check Show download button.
After your customizations are complete, copy the code. You can also click Save preset to set it as a pre-determined sizesfor other DAM users to select.
Customizing manually
For images, share links and embed codescan be customized by manually changing the dimensions, cropping (the keep area), or background color. Here's an example of an embed code:
The order of the parameters in the URL before the question mark cannot be changed. However, all parameters after the question mark can be ordered in any way.
Image size
To specify an exact image size, provide both the width (width= or w=) and the height (height= or h=). To specify the size of a landscape image and preserve its aspect ratio, specify only the width. Likewise, for a portrait image, specify only the height. If you don't specify either width or height, the Acquia DAM will provide you with an image based on the original asset size, up to a maximum of 2,048 pixels in the longest dimension.
If you specify the retina parameter (&retina=true), the pixel size that's returned will be doubled. For example, if you request w=300 and h=200, the DAM will return an image with a pixel size 600x400. This is typically used to display with high pixel density.
Filename
The filename, while not required in a share link or embed code, is recommended for search engine optimization purposes. You can change or remove the filename and it will have no effect on the link path or the asset in DAM.
Image format
The image format can be GIF, JPEG, PNG, WEB, or WEBP. GIF or PNG formats are best for logo and line art images. If it's important to retain transparency in your embed codes, use the PNG format. If transparency isn't important but a smaller file size is, use the JPEG or WEBP format. If you don't have a preference, use the WEB format, which is a smart format that allows the DAM to pick the most appropriate format based on the characteristics of the asset.
This table illustrates the formats listed above and corresponding content that's included in the share link or embed code.
Format
Code content
GIF
image/gif
JPEG
image/jpeg
PNG
image/png
WEB
image/jpeg*, image/png*, image/webp*
WEBP
image/webp
*Returned image depends on the format of the asset.
Options
Options are specified as URL query parameters. Immediately after the image format, add a question mark ( ? ). Additional options are separated by the ampersand ( & ). An equals ( = ) sign is used to separate the option name from the option's value.
Quality
Name: quality or "q" Default: 80 Value: Integer from 0 (lowest quality) to 100 (highest quality) *For JPEG images only
Name: DPI or “dpi” Default: 72
The quality parameter determines image file size compression, whereas DPI determines the number of ink dots on a printed image. If this DPI parameter is not set in the customized embed code, the image's physical resolution is unspecified. Some formats like WEBP don’t require DPI, whereas some do, such as JPEG. For image formats that require it, if no DPI is set, these images will be given a default DPI of 72.
Embed code for a video without a player
For video embeds without a player, HD or SD quality parameters can be specified. The following are examples for each option:
For video embeds with an integrated player, specifying quality is unnecessary. The player automatically optimizes the quality based on network conditions and display size.
Name: crop Default: True Value: Boolean value. "true," "yes," or "y" for true. "false," "no," or "n" for false.
Crop area values are valid when you specify the image width and height. When true, the image is cropped to fit the aspect ratio of the requested size. When false, the image is created with an additional background area.
Keep area
Name: keep or "k"
Default: center
Value:
"c" = center "n" = north "ne" = northeast "e" = east "se" = southeast "s" = south "sw" = southwest "w" = west "nw" = northwest "smart" = AI-powered focal point detection
When you set the crop value to true, the primary area preserved is controlled by the keep value.
Smart crop
Smart crop uses AI-powered focal point detection to identify the visual subject of an image and crop to the requested dimensions relative to that point. You do not need to specify a fixed direction.
Prerequisite:
An administrator must enable the Smart crop toggle at /admin/features (under Manage Assets, labeled as AI) before you can use this parameter.
Availability: Smart crop is available for image assets only.
Syntax:
Add keep=smart to your embed link URL along with crop=true and the target dimensions.
This returns a 1500x1500 pixel image cropped around the detected focal point of the image.
Example: 1500x1500 crop comparison
The following images demonstrate how smart crop compares to center crop on a cherry blossom photograph.
Original image: Original cherry blossom tree against blue sky - full composition, no crop applied
keep=c (center crop):
1500x1500 center crop - anchors to the center of the image, resulting in the blossoms being partially cut off with mostly sky and black letterboxing visible
keep=smart (smart crop):
1500x1500 smart crop - detects the blossoms as the focal point, preserving better balance of subject and background
Comparison with fixed-anchor cropping:
Parameter
Behavior
keep=c
Preserves the center of the image regardless of subject position
keep=n
Preserves the top (north) area of the image
keep=smart
Detects the visual focal point and preserves the area around it
When smart crop is most effective:
Photographs with a clear subject, such as portraits, product shots, or wildlife
Hero banners and thumbnails from a mixed-composition library
Content where subject position varies across assets
Where results may vary:
Abstract images without a clear focal point
Graphic design compositions with evenly distributed elements
Infographics and text-heavy images
Low-contrast images where subject and background are similar
Notes:
You must set crop=true (or crop=yes) alongside keep=smart.
If the Smart crop toggle is not enabled on your site, the keep=smart parameter is ignored.
Smart crop does not support manual focal point overrides.
Smart crop does not apply to video or non-image assets.
Background color
Name: color or "co" Default: ffffff (white) Value: RGB color value specified as in HEX format
When you set the crop option to false, additional background areas are created with the specified color. Example HTML color codes are available.
Video autoplay
To configure autoplay in embed codes for videos with a player, add this: t.autoplay=true&t.muted=true
For example, the video embed code would look like:
Acquia DAM (Widen)