diff --git a/CHANGELOG.md b/CHANGELOG.md
index d059ac22ed0..c1a886700ba 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,7 @@
- Added `Enter` key press functionality to `EuiSuperDatePicker` ([#3048](https://github.com/elastic/eui/pull/3048))
- Added `title` to headers of `EuiTable` in case of truncation ([#3094](https://github.com/elastic/eui/pull/3094))
- Added i18n to `EuiTableHeaderCell` ([#3094](https://github.com/elastic/eui/pull/3094))
+- Added `number` and `string` to `size` type of `EuiImage` for setting custom sizes ([#3012](https://github.com/elastic/eui/pull/3012))
**Bug Fixes**
diff --git a/src-docs/src/views/image/image_example.js b/src-docs/src/views/image/image_example.js
index d2232cbbc40..2bef54d0f2c 100644
--- a/src-docs/src/views/image/image_example.js
+++ b/src-docs/src/views/image/image_example.js
@@ -30,7 +30,7 @@ const imageZoomSource = require('!!raw-loader!./image_zoom');
const imageZoomHtml = renderToHtml(ImageZoom);
const imageZoomSnippet = `
`;
@@ -53,39 +53,8 @@ export const ImageExample = {
Use EuiImage when you need to place a static
- image into a page with an optional caption. It has the following
- props.
+ image into a page with an optional caption.
-
-
- size accepts{' '}
- s / m / l / xl / original / fullWidth. The
- latter will set the figure to stretch to 100% of its container.
-
-
- allowFullScreen when set to true will make the
- image clickable to a larger version.
-
-
- fullScreenIconColor allows you to change the
- color of the icon that floats above the image when it can be
- clicked to fullscreen. The default value of{' '}
- light is fine unless your image has a white
- background, in which case you should change it to{' '}
- dark.
-
-
- hasShadow when set to true (default) will apply
- a slight shadow below the image.
-
-
- caption will provide a caption to the image.
-
-
- alt Sepearate from the caption is a title on
- the alt tag itself. This one is required for accessibility.
-
Images can be sized by passing the size prop a
- value of s / m / l / xl / original / fullWidth.
- Note that this size is applied to the width of the image.
+ value of{' '}
+
+ s / m / l / xl / original / fullWidth / number / string
+
+ . This size sets the maximum length of the longest
+ edge of the image, whether that is height or width, and scales it.
+ Only the provided sizing values will also increase the size of a
+ smaller image.