Image | Fit Mode | Contentstack

Fit to bounds

GET

https://images.contentstack.io/v3/assets/{stack_api_key}/{asset_uid}/{file_uid}/filename.jpg?environment={environment_name}&width={width_value}&height={height_value}&fit={fit_value}

Note Check out the limitations that are applicable here.

Hide Parameters

Query Parameters

heightoptionalstring

Enter the value of the image height in pixels or percentage. Example 250 or 0.50

Example:

0.50

fitoptionalstring

Enter either bounds or crop as value. Example bounds

Example:

bounds

widthoptionalstring

Enter the value of the image width in pixels or percentage. Example 250 or 0.50

Example:

0.50

environmentrequiredstring

Enter the environment scoped to your delivery token.

Example:

production

If fit is set to bounds, it will constrain the given image into the specified height and width.

Fit to cover

GET

https://images.contentstack.io/v3/assets/{stack_api_key}/{asset_uid}/{file_uid}/filename.jpg?environment={environment_name}&width={width_value}&height={height_value}&fit={fit_value}

NoteThe fit parameter requires both the height and the width parameters.

Hide Parameters

Query Parameters

widthoptionalstring

Enter the value of the image width in pixels or percentage. Example 250 or 0.50

Example:

250

heightoptionalstring

Enter the value of the image height in pixels or percentage. Example 250 or 0.50

Example:

250

fitoptionalstring

Pass the fit value as cover to resize the image to entirely cover the specified region, making one dimension larger if needed.

Example:

cover

environmentrequiredstring

Enter the environment scoped to your delivery token.

Example:

production

If fit is set to cover, it resizes the image (shrinks or enlarges) to fill the entire area defined by the width and height parameters. If the image's aspect ratio differs from the specified dimensions, it will be cropped centrally to fit.

Fit by cropping

GET

https://images.contentstack.io/v3/assets/{stack_api_key}/{asset_uid}/{file_uid}/filename.jpg?environment={environment_name}&width={width_value}&height={height_value}&fit={fit_value}

Additional Notes

The fit parameter requires both the height and the width parameters.

Note Check out the limitations that are applicable here.

Hide Parameters

Query Parameters

widthoptionalstring

Enter the value of the image width in pixels or percentage. Example 250 or 0.50

Example:

250

heightoptionalstring

Enter the value of the image height in pixels or percentage. Example 250 or 0.50

Example:

250

fitoptionalstring

Enter either bounds or crop as value. Example crop

Example:

crop

environmentrequiredstring

Enter the environment scoped to your delivery token.

Example:

production

If fit is set to crop, it will crop the given image to the defined height and width.