Accessora

Documentation

Accessora Documentation

Everything you need to know about the accessibility widget and platform.

Getting Started

Installation

  1. Install Accessora from the Shopify App Store.
  2. Approve the app permissions and subscription charge.
  3. Complete the onboarding flow to configure your widget.
  4. The widget automatically appears on your storefront — no code changes required.

Choosing a Plan

Accessora offers multiple plan tiers with different feature limits and quotas. Compare plans on our Pricing page to find the right fit for your store. You can upgrade or downgrade at any time from the Accessora dashboard.


Widget Features

The Accessora widget provides up to 18 accessibility features, organized into three categories.

Vision

FeatureDescription
Font SizeIncrease or decrease text size across the page.
ContrastSwitch between high contrast, inverted, and dark/light modes.
BrightnessAdjust page brightness up or down.
Invert ColorsInvert the entire page color scheme.
SaturationIncrease or decrease color saturation.
Color FiltersApply color overlays to aid users with color vision deficiencies (protanopia, deuteranopia, tritanopia).
Hide ImagesRemove images from the page for a distraction-free experience.

Reading

FeatureDescription
Reading LineDisplay a horizontal guide line that follows the cursor to aid reading focus.
Reading MaskDim the page except for a horizontal strip around the cursor.
Dyslexic FontSwitch body text to OpenDyslexic, a typeface designed for readers with dyslexia.
Bionic FontBold the first portion of each word to guide the eye and improve reading speed.
Line HeightIncrease spacing between lines of text.
Highlight LinksVisually highlight all links on the page.
TooltipsShow descriptive tooltips on interactive elements.
FeatureDescription
Page StructureDisplay a navigable outline of the page’s heading hierarchy.
Text-to-SpeechRead selected text aloud using the browser’s speech synthesis.
Bigger CursorEnlarge the mouse cursor for improved visibility.
Stop AnimationsPause CSS animations, transitions, and GIFs.

Accessibility Profiles

Profiles apply a curated set of features with a single click, tailored to specific needs:

  • ADHD Profile: Reduces distractions by stopping animations, applying a reading mask, and increasing line height.
  • Cognitive Profile: Simplifies the reading experience with bionic font, highlighted links, and tooltips.
  • Low Vision Profile: Enhances visibility with larger font size, high contrast, increased brightness, and a bigger cursor.
  • Motor Impairment Profile: Improves navigation with page structure, highlighted links, and a bigger cursor.

Profiles can be toggled on and off. Activating a profile overrides individual feature settings; deactivating restores previous settings.


AI Image Captions

Accessora uses Azure Computer Vision to automatically generate descriptive alt text for your product images.

How It Works

  1. You trigger caption generation from the Accessora dashboard (individually or in bulk).
  2. Accessora sends product image URLs to Azure Computer Vision.
  3. The AI returns descriptive captions with confidence scores.
  4. Captions are stored and served through the widget’s automated fixes, filling in missing alt text.

Important Notes

  • Caption generation counts against your plan’s monthly quota.
  • AI captions may not be 100% accurate — we recommend reviewing generated captions, especially for complex or specialized products.
  • Captions are applied as runtime DOM overlays via the widget. They do not modify your Shopify product data.

Accessibility Audits

Automated WCAG audits analyze your web pages and report accessibility violations.

How It Works

  1. Submit a page URL for auditing from the Accessora dashboard.
  2. Accessora loads the page in a headless browser (Puppeteer) and runs Axe-Core accessibility tests.
  3. Results include a list of violations categorized by severity (critical, serious, moderate, minor) and an overall compliance score.

Understanding Results

  • Critical: Issues that prevent users from accessing content (e.g., missing alt text on key images, no keyboard navigation).
  • Serious: Significant barriers that make content difficult to use (e.g., insufficient color contrast, missing form labels).
  • Moderate: Issues that cause inconvenience (e.g., heading hierarchy gaps, redundant links).
  • Minor: Best-practice improvements (e.g., missing landmark roles).

Audits are automated estimates. For legal compliance verification, we recommend supplementing with manual accessibility testing.


Automated Fixes

Accessora can automatically detect and fix common accessibility issues on your storefront in real time.

Resolvers

ResolverWhat It Fixes
Image ResolverAdds missing alt text to images using AI-generated captions or descriptive fallbacks.
Form ResolverAssociates labels with form inputs, adds missing aria-label attributes.
Link ResolverAdds accessible names to empty or ambiguous links.
Heading ResolverFlags and adjusts heading hierarchy issues for proper document structure.
Clickable Element ResolverEnsures clickable elements have proper roles and keyboard accessibility.
ARIA Landmark ResolverAdds missing landmark roles (main, nav, banner, contentinfo) to page regions.

Important Notes

  • All fixes are non-destructive runtime DOM overlays. They do not modify your theme code or Shopify data.
  • Fixes are applied each time the widget loads on a page.
  • Automated fixes address common issues but cannot resolve all accessibility barriers.

Widget Customization

Themes

Choose from built-in themes or create a custom theme to match your brand. Configure colors, border radius, and opacity from the dashboard.

Icon and Position

Select a widget trigger icon and position it on the left or right side of the screen. Adjust vertical offset to avoid conflicts with other floating elements.

White Label

Higher-tier plans allow you to remove Accessora branding from the widget for a fully branded experience.

Languages

The widget interface is available in 26 languages: Bulgarian, Czech, Danish, Dutch, English, Estonian, Finnish, French, German, Greek, Croatian, Hungarian, Irish, Italian, Japanese, Latvian, Lithuanian, Norwegian, Polish, Portuguese, Romanian, Slovak, Slovenian, Spanish, Swedish, and Turkish.

Language can be set to auto-detect from the browser or fixed to a specific language.


Analytics Dashboard

The analytics dashboard provides aggregated, anonymous data about how visitors interact with the widget:

  • Impressions: How often the widget is seen and opened.
  • Feature Usage: Which accessibility features are most used.
  • Profile Usage: Which accessibility profiles are activated.
  • Language Distribution: Which widget languages are used by visitors.

All analytics are aggregated daily. No personally identifiable information is collected.


Keyboard Shortcuts

The widget supports the following keyboard shortcuts for quick access:

ShortcutAction
Ctrl + Shift + FToggle font size increase
Ctrl + Shift + DToggle dyslexic font
Ctrl + Shift + CToggle high contrast
Ctrl + Shift + RToggle reading line

Keyboard shortcuts can be enabled or disabled from the widget settings.


FAQ and Troubleshooting

The widget is not appearing on my store

  • Verify the app is installed and your subscription is active in the Accessora dashboard.
  • Check that the widget is enabled in your settings.
  • Clear your browser cache and disable any ad blockers that might interfere.
  • If using a custom theme, ensure the Shopify app embed block is activated in your theme editor.

My caption or audit quota has run out

Quotas reset at the start of each billing cycle. You can upgrade your plan for higher quotas, or wait for the next cycle.

The widget looks different on mobile

The widget is fully responsive. On smaller screens, the widget panel opens as a fullscreen overlay for better usability.

Automated fixes are not applying

  • Ensure automated fixes are enabled in your widget configuration.
  • Fixes apply at page load — dynamically loaded content may not be caught on initial render.
  • Check the browser console for any JavaScript errors.

Need more help?

Contact our support team at [email protected] or visit the Support page.