Accessibility
Ensuring your chatbot meets AA accessibility standards is a duty that must be undertaken by both Open Dialog and our clients.
While the code and user experience meet the necessary AA criteria, work must be done to ensure that the bot interface settings and message types also meet the required criteria.
By default, our out-of-the-box chatbot meets AA standards. Therefore, any changes you make to its design (colour, font, message contents) should be checked against these criteria to ensure AA compliance in your regulated industry.
To make this easier, we have collated a list of do's and don'ts to help you build your bot, with confidence.
Typography
Always use a sans-serif typeface in your chatbot.
![A comparison between Sans-serif and serif fonts](https://docs.opendialog.ai/~gitbook/image?url=https%3A%2F%2F3203401256-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FdP6xFXXyeBbibro1Ywnq%252Fuploads%252FfLOfKTRgDxk6IGZBm36V%252FText.png%3Falt%3Dmedia%26token%3D9a1cc769-83af-4317-b954-f3a3008257c0&width=768&dpr=4&quality=100&sign=d2c5e172&sv=1)
A sans-serif font such as Arial, Helvetica or Tahoma provides maximum readability to your customers. Fonts like Times New Roman, Garamond, or a custom/bespoke font will provide poor legibility (especially for those with visual impairments) and should be avoided.
Images
All images require an alt tag, excluding those that are decorative.
![An example of writing good alt tags using a photo of a girl practising the guitar. The first is descriptive of the image content. The second example says only 'guitar'.](https://docs.opendialog.ai/~gitbook/image?url=https%3A%2F%2F3203401256-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FdP6xFXXyeBbibro1Ywnq%252Fuploads%252FCEJQjA73MGCOBO6fYHCD%252FAlt%2520tags.png%3Falt%3Dmedia%26token%3D1fc0a255-2d63-409a-bc33-0de76a3296c6&width=768&dpr=4&quality=100&sign=c8920e76&sv=1)
When creating an alt tag, it's best practice to describe the information, not the picture. For example, the alt text for an image of a person typing on a computer could be "Woman optimizing website for SEO" or "Woman researching free blogging platforms," depending on the topic of the conversation. This means screen readers can provide context to customers who may not be able to perceive the image clearly.
There are also times when an alt tag is not required.
![An example of when an alt tag is not required, next to a decorative image that does not require an alt tag](https://docs.opendialog.ai/~gitbook/image?url=https%3A%2F%2F3203401256-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FdP6xFXXyeBbibro1Ywnq%252Fuploads%252FtMq20qSzxPbfZEAPC7yw%252FNull%2520alt%2520tag.png%3Falt%3Dmedia%26token%3D434f5db6-4fc1-4e85-90d4-733193100c93&width=768&dpr=4&quality=100&sign=cae595aa&sv=1)
In this example, the image provides no meaningful information and can be considered 'decorative'. Therefore, you do not need to add an alt tag. Open Dialog will automatically add a 'Null' state, meaning assistive technologies will ignore announcing the alt tag, ensuring you are compliant.
Avoid flashing images
![A comparison image showing side by side smiley faces. One is static, the other flashes in a strobe like motion.](https://docs.opendialog.ai/~gitbook/image?url=https%3A%2F%2F3203401256-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FdP6xFXXyeBbibro1Ywnq%252Fuploads%252FuWiZPJwQA7P8QFVYWlrS%252Fsmiley%2520flash.gif%3Falt%3Dmedia%26token%3Dd610212a-32e7-4144-ab25-af632975cd13&width=768&dpr=4&quality=100&sign=aac9244&sv=1)
If you choose to use gifs or moving images, avoid those that flash or appear to strobe in any way to ensure you maintain AA accessibility standards. If the image is pertinent to the conversation (i.e. isn't classed as decorative) ensure you also include an alt tag.
Avoid text in images where possible, and use alt tags when not
![A side by side comparison of the same image, with a girl practising guitar and a text overlay saying 'Book now'.](https://docs.opendialog.ai/~gitbook/image?url=https%3A%2F%2F3203401256-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FdP6xFXXyeBbibro1Ywnq%252Fuploads%252F1K07eH1HGs0uW4Lj7JtX%252FImages%2520in%2520text.png%3Falt%3Dmedia%26token%3D839fd3a2-62e3-4cdb-a909-12c67fb11aac&width=768&dpr=4&quality=100&sign=d03c220d&sv=1)
Where possible text burned into images (i.e. when an image is saved with text as part of the pixel data) should be avoided. There may be times when it's not possible to avoid this. In such cases, use the alt tag to describe the information.
This is also true if you are using images with graphs or pictorial information, and alt tags should once again be used.
Colour
Abide by AA colour contrast specifications
![A side by side comparison displays AA compliant levels of colour contrast against non compliant colour contrast standards](https://docs.opendialog.ai/~gitbook/image?url=https%3A%2F%2F3203401256-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FdP6xFXXyeBbibro1Ywnq%252Fuploads%252F9ImdIgZ3VpB0dT7nQt5Q%252FColour%2520contrast.png%3Falt%3Dmedia%26token%3D9b476bb6-9366-42ee-9182-0d7cce078401&width=768&dpr=4&quality=100&sign=8a20d9a&sv=1)
Choosing the right colour contrast levels can be tricky, as there are layers to this level of compliance. The most important elements such as text, buttons and other information should be a minimum of 4.5:1 contrast level.
In turn, those elements then need to score 3:1 contrast against any background elements.
In the left-hand image example above, the customer message has been set with white text on a blue background - which measures 7.8:1 colour contrast. The background of the message then contrasts at a level of 6.7:4 against the background; so in both cases, this is a successful pass.
In terms of the chatbot message, this measures 13:1 for the text against the background, and then 3:1 for the button background and the chat window background. Again, a successful test on both accounts.
In the right-hand example, we can see that every colour setting produces an accessibility failure, with no one value displaying the required criteria.
Consider Dyslexia and colour vision
Choosing the right colours for neurodivergent customers is also an important part of designing the interface of your chatbot.
Typically, these types of customers prefer:
Use of dark-coloured text on a light (not white) background
Avoid green and red/pink, as these colours are difficult for those who have colour vision deficiencies (colour blindness)
Avoid stark colour usage i.e. Black #000000 text on White #FFFFFF
Other considerations
It's also good practice to review your chatbot in greyscale to ensure any actions (such as clicking a button) are perceived with ease. This can be done with many free extensions for the browser of your choice.
Content
Avoid generic buttons and link labels
![A side by side comparison of how to label buttons effectively and poorly](https://docs.opendialog.ai/~gitbook/image?url=https%3A%2F%2F3203401256-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FdP6xFXXyeBbibro1Ywnq%252Fuploads%252FSsksYUHVOjJHVYrzEVN0%252FButtons.png%3Falt%3Dmedia%26token%3D7396c976-d153-45ac-84bb-dc6c13888928&width=768&dpr=4&quality=100&sign=8953b4c&sv=1)
Button labels should describe what the customer can expect if they click them. Using a generic phrase like 'See more' or 'Discover now' is inaccessible, and doesn't give customers any context over what they can expect.
We recommend using plain and simple language where possible, and where there is an implied action, support that action with a verb. For example, a button that allows a customer to review their car insurance documents could say 'Review now' or even 'Policy documents' - however it fails to capture what the customer can expect to see or what they need to do in the context of their customer journey. A better option would be 'Review policy documents' which is more explicit and action-based.
Lastly, you should also avoid adding bare URLs such as www.google.co.uk as the button labels. This includes shortened URLs such as 'Bitly'.
Use example content within placeholder text
![A side by side comparison shows 2 form fields. The left hand one displays helpful placeholder text, the right hand one show unhelpful placeholder text](https://docs.opendialog.ai/~gitbook/image?url=https%3A%2F%2F3203401256-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FdP6xFXXyeBbibro1Ywnq%252Fuploads%252FXKw5MmjY7F6S0QSDwPdz%252FPlaceholders.png%3Falt%3Dmedia%26token%3D1947efa7-f5b3-413e-a58f-34159e4b23a6&width=768&dpr=4&quality=100&sign=87cd9b52&sv=1)
When used sparingly (placeholders are not essential for accessibility compliance) placeholder text can be beneficial for customers.
For example, when asking a customer to 'Enter your email address', including the placeholder 'e.g. user@domain.com' provides them with further context on what type of information they need to provide and the correct format.
For more complex requests such as 'What is your policy number', a supporting placeholder that follows the policy number format 'e.g. PL-123-4567-AB' would help customers locate and enter the correct information you are requesting from them.
Avoid repeating the same instruction as the field label within your placeholder text. This is likely to confuse customers and increase the risk of task failure.
Reading age
Using a low reading age helps people with reading disabilities to understand your content, while also allowing authors to publish difficult or complex Web content with ease.
For example, instead of 'Precipitation' use 'Rain' or 'Snow' instead. The easier you make it for customers to read and understand the content, the more likely they are to complete a task and not require your support.
Keep messages as concise as possible to avoid overwhelming or confusing customers. Heavily verbose messages take more time to read and comprehend, therefore using short messages, breaking content up into separate messages, and keeping messages succinct will benefit every customer.
There will be times when you need to use language that might be considered advanced reading level, such as within insurance policy documents. If the text cannot be made more readable, then supplemental content is required such as plain English explanations, or other support materials.
You should also avoid jargon or slang that a customer might not understand, such as 'YOLO'.
Use emojis sparingly, and include them at the end of sentences to avoid breaking up a message and its context.
Message speed
![The 'Typing Cvent' setting within the Open Dialog conversation designer, shows how to adjust message speed using a numerical value](https://docs.opendialog.ai/~gitbook/image?url=https%3A%2F%2F3203401256-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FdP6xFXXyeBbibro1Ywnq%252Fuploads%252FzTcyp5lgSHA6TtSjQHmG%252Fimage.png%3Falt%3Dmedia%26token%3Dd30d0086-5887-4676-ba71-dc226bba28e6&width=768&dpr=4&quality=100&sign=392842e6&sv=1)
Showing too many messages too quickly can be difficult for some customers to keep track of and comprehend, specifically if English is not their first language. It's better to slow things down a little and give them some space to read.
The conversation designer allows you to adjust the speed at which messages are shown to users within the interface settings. Increasing the timing will add more pauses between messages, meaning you can better support customers and provide more time to follow and understand the conversation more easily.
Accessibility declaration
To achieve AA accessibility standards, your site must have an accessibility statement which not only complies but directly relates to the site. While this is not the duty of Open Dialog, it's worth noting the importance of its inclusion.
Last updated