---
title: Configuring accessibility declarations for your app
framework: appstoreconnectapi
role: article
role_heading: Article
path: appstoreconnectapi/configuring-accessibility-declarations
---

# Configuring accessibility declarations for your app

Manage accessibility metadata for your apps per device family.

## Overview

Overview You use the App Store Connect API to create and configure accessibility declarations for your app. After you create an accessibility declaration, you can update the list of supported features, and also remove the accessibility declaration. Accessibility declarations enable you to show the accessibility modalities and the specific features that your app supports. Once you create an accessibility declaration, your App Store page shows the accessibility details for your app. You make accessibility declarations for each app and these apply to a device family, such as IPHONE, IPAD, or VISION, to learn more, see DeviceFamily. Use this term list and table to understand what details to include in your app’s accessibility declaration. Read accessibility feature details Here’s what each accessibility feature provides: Read accessibility feature device family compatibility This table shows the compatibility for each accessibility feature and platform:  |  |  |  |  |  |   |  |  |  |  |  |   |  |  |  |  |  |   |  |  |  |  |  |   |  |  |  |  |  |   |  |  |  |  |  |   |  |  |  |  |  |   |  |  |  |  |  |   |  |  |  |  |  |   |  |  |  |  |  |  Create an accessibility declarations for your app After you determine the accessibility features your app supoorts, create an accessibility declaration, by using Create an Accessibility Declaration with a payload. Here’s an example payload: {   "data": {     "type": "accessibilityDeclarations",     "attributes": {       "deviceFamily": "IPHONE",       "supportsAudioDescriptions": true,       "supportsCaptions": true,       "supportsDarkInterface": true,       "supportsDifferentiateWithoutColorAlone": true,       "supportsLargerText": true,       "supportsReducedMotion": true,       "supportsSufficientContrast": true,       "supportsVoiceControl": false,       "supportsVoiceover": false     },     "relationships": {       "app": {         "data": {           "type": "apps",           "id": "{appID}"         }       }     }   } }

The response includes a unique identifier. Each device family your app supports can have their own accessibility declaration. To learn more, see DeviceFamily. Read the accessibility declarations for your app You can use Read Accessibility Declaration Information with the unique identifier from the POST call you made, to look up the details of your current accessibility declaration. You can also get that unqiue identifier by using List All Accessibility Declarations for an App. note: The response value for Read Accessibility Declaration Information includes the state attribute, which indicates whether your accessibility declaration appears on your App Store page. Modify the accessibility declarations for your app If you need to update your accessibility declaration, use Modify an Accessibility Declaration. You can supply any number of the available attributes with a corresponding Boolean value when modifying an accessibility declaration when it is in DRAFT state. Publishing the accessibility declarations for your app When you are ready to show your accessibility declarations on your app’s page in the App Store, use Modify an Accessibility Declaration with a payload like this: {   "data": {     "type": "accessibilityDeclarations",     "id": "<id>",     "attributes": {       "publish": true     }   } } Remove an accessibility declaration for your app If you need to remove an accessibility declaration for an app, use Delete an Accessibility Declaration. You can only remove accessibility declarations that are in the DRAFT state. This deletes the declaration details. To create a new accessibility declaration, use Create an Accessibility Declaration.