Programmable Media

Accessibility analysis

Last updated: Jul-16-2024

Analyzing your images for accessibility can help you to choose the best images for people with color blindness.

Important
Accessibility analysis is currently in Beta. Some implementation details may change before the official release. If you have a paid account, you can request to take part in the Beta trial. We invite you to share any feedback via our support team.

You can request accessibility analysis while uploading an image, or by using the explicit method on an already uploaded image.

Accessibility analysis while uploading

You can request accessibility analysis while uploading by specifying the accessibility_analysis parameter in the upload method.

For example, uploading the "user_photo.jpg" image and requesting accessibility analysis:

Accessibility analysis on already uploaded images

There are two ways to request quality analysis on already uploaded images:

  • Use the Explicit method of the Upload API to request quality analysis on a single asset. This method is not rate-limited and requires a signature to be generated on the server side.
  • Use the Update resources method of the Admin API. This method is rate-limited and requires your API key and secret, so is not suitable for use in client-side code.

Explicit example

The following example uses the Explicit method of the Upload API to request quality analysis on the image with a public ID of "user1":

Update resources example

The following example uses the Update resources method of the Admin API to request quality analysis on an uploaded image with a public ID of "table":

Sample response

  • distinct_edges is a score between 0 and 1. A low score indicates that there are parts of the image that may be camouflaged to people with color blind conditions. For example, in this image, the grasshopper appears camouflaged to people with the color blind condition, deuteranopia:
Red flower with green grasshopper "distinct_edges": 0 Grasshopper camouflaged when simulating color blind condition Deuteranopia simulation
  • distinct_colors is a score between 0 and 1. A low score indicates that there are colors that color blind people would find hard to differentiate between. In this example, the red and green slices of the pie chart appear the same to someone with deuteranopia:
Pie chart in red, green, blue and yellow "distinct_colors": 0.33 Red and green indistinguishable when simulating color blind condition Deuteranopia simulation
  • most_indistinct_pair shows the two colors (in RGB hex format) that color blind people would find the hardest to tell apart.
  • colorblind_accessibility_score is an overall score, taking each of the components into account.

The accessibility_analysis.colorblind_accessibility_score field can be used in the search method when accessibility_analysis is set to true, in the upload request or an upload preset. Note that this score is not indexed for search when returned as part of an explicit request.

Video tutorial: image accessibility with JavaScript

Watch this video tutorial to understand how Cloudinary can help you with color accessibility.

✔️ Feedback sent!

Rate this page: