Table of Contents
ScrollAccess Website Translation Setup: API Keys & Language Guide
Introduction to Website Translation with ScrollAccess
Making a website accessible to a wider audience involves more than providing readable content and easy navigation. Visitors may speak different languages, so offering translation options can help them understand website information and interact with digital content more comfortably. ScrollAccess supports optional translation capabilities through its website accessibility toolbar and a separate dashboard translation workflow.
With ScrollAccess Website Translation, website owners can configure supported translation providers, manage API credentials, and enable language-related features where available. The plugin supports Google Cloud Translation, DeepL, and LibreTranslate integrations, allowing administrators to configure a provider according to their requirements.
This guide explains how to configure translation API keys, select a suitable provider, manage language settings, and troubleshoot common translation problems.
What Is Website Translation in ScrollAccess?
Website translation allows users to access website content in a language they understand. For businesses, educational platforms, service providers, and online stores, language support can help create a more welcoming experience for international visitors.
ScrollAccess provides translation as an optional capability rather than a mandatory toolbar feature. Administrators can configure the available translation provider and enable translation in the relevant workflow.
The platform includes two distinct areas to understand:
- Toolbar translation: Translation functionality can be made available to website visitors when enabled and properly configured.
- Dashboard translation: A separate translation configuration and workflow is available within the dashboard.
These workflows may have different settings and requirements. Administrators should configure the appropriate area for their intended use instead of assuming that enabling translation in one location automatically activates it everywhere.
Supported Translation Providers
ScrollAccess supports three translation-provider integrations. Each offers different configuration requirements and service characteristics.
1. Google Cloud Translation
Google Cloud Translation is a machine translation service that can translate text between supported languages. ScrollAccess supports integration through a Google API key.
To use this provider, administrators should create or configure the relevant Google Cloud project, enable the required translation service, and obtain an API key. The key must have the necessary permissions and restrictions configured for the integration.
Before activating the feature, verify that the API is enabled, billing requirements are satisfied, and the requested source and target languages are supported.
2. DeepL Translation
DeepL provides machine translation services with Free and Pro API options, subject to account eligibility and provider-specific requirements.
ScrollAccess supports DeepL integration based on the configured API key. Make sure you use the appropriate key for your DeepL API account. Free and Pro API credentials may use different service endpoints or account arrangements, so the correct configuration is important.
Check your account’s usage limits, supported languages, and subscription requirements before enabling translation for visitors.
3. LibreTranslate
LibreTranslate is an open-source machine translation platform that can be deployed through supported hosting arrangements. ScrollAccess supports the managed LibreTranslate endpoint used by the plugin.
Depending on the endpoint configuration, an API key may or may not be required. If credentials are necessary, obtain them from the relevant service provider and enter them in the appropriate configuration field.
Also verify that the configured endpoint is reachable from your server and that it supports the languages you intend to offer.
How to Configure a Translation API Key
Follow these general steps to set up a supported translation provider in ScrollAccess.
Step 1: Obtain Your Provider Credentials
Choose Google Cloud Translation, DeepL, or LibreTranslate according to your requirements. Follow the selected provider’s official setup process to obtain the necessary API key or endpoint details.
Keep your credentials secure and avoid sharing them publicly.
Step 2: Open Translation Settings
Sign in to your ScrollAccess dashboard and navigate to the translation settings for the relevant workflow. Confirm whether you are configuring visitor-facing toolbar translation or dashboard translation.
Step 3: Select a Translation Provider
Choose the provider you want to use from the available options. Review the provider-specific configuration fields before proceeding.
Step 4: Enter the API Key
Paste your API key into the corresponding field when the selected provider requires one. For LibreTranslate, follow the configured endpoint’s authentication requirements.
Double-check the credentials for missing characters, spaces, or incorrect account keys.
Step 5: Configure Language Options
Select or enable the languages required by the relevant translation workflow. The plugin checks supported source and target language combinations through provider capability checks.
Remember that not every provider supports every language pair. Confirm compatibility before making a language available to visitors.
Step 6: Save Your Configuration
Save the translation settings and review any validation messages. Ensure that the selected provider and its credentials are associated with the intended workflow.
Step 7: Test the Translation Feature
Use the available test or translation workflow to verify that the provider accepts the credentials and supports the selected language pair. If you are configuring toolbar translation, check the feature on the website as well as in the dashboard.
Test with representative website content before making the feature widely available.
How to Troubleshoot Translation Problems
Even with correct settings, translation may occasionally fail because of provider restrictions, connectivity problems, or unsupported language combinations.
Invalid API key: Confirm that you copied the correct key and that it belongs to the intended provider account.
API service not enabled: For Google Cloud Translation, verify that the relevant service is enabled in the correct project.
Billing or quota issues: Review the provider’s billing status, usage allowance, rate limits, and quota restrictions.
Incorrect DeepL credentials: Check whether your key corresponds to the correct DeepL API plan and configuration.
Unsupported language pair: Confirm that the provider supports both the source and target languages selected for translation.
Endpoint connectivity problems: For LibreTranslate, verify the configured endpoint, server connectivity, and authentication requirements.
Translation not appearing in the toolbar: Confirm that toolbar translation is enabled and that the correct workflow has been configured. Also check whether caching or other website settings are affecting the latest configuration.
When troubleshooting, test one issue at a time and review any error messages available in the dashboard or provider account. Avoid exposing API keys in public error reports or screenshots.
Best Practices for Website Language Features
For a reliable multilingual experience, keep translation configuration simple and secure.
- Use API keys only for their intended integrations.
- Apply provider-supported restrictions and permissions wherever possible.
- Monitor usage, billing, and provider quotas regularly.
- Enable only the languages relevant to your audience.
- Test translations before publishing changes.
- Review translated content for important business, legal, and technical information.
- Keep website accessibility improvements separate from translation functionality.
Machine translation can help visitors understand website content, but it does not guarantee perfect accuracy. Important information may require review by a qualified human translator. Likewise, translating a website does not automatically make it compliant with WCAG requirements or applicable accessibility laws.
Conclusion
ScrollAccess provides flexible website translation options through Google Cloud Translation, DeepL, and LibreTranslate integrations. By configuring the appropriate credentials, checking language compatibility, and testing the selected workflow, administrators can make translation functionality available where supported.
For the best results, keep credentials secure, monitor provider usage, and test the visitor-facing toolbar independently from dashboard translation. A well-configured language feature can complement a broader accessibility strategy and help more visitors engage with your website.
Frequently Asked Questions
Which translation providers does ScrollAccess support?
ScrollAccess supports Google Cloud Translation, DeepL, and LibreTranslate integrations.
How do I add a translation API key?
Open the relevant translation settings, select a provider, enter the required credentials, and save your configuration.
Is translation available in the accessibility toolbar?
Yes, toolbar translation can be enabled when the feature is configured and supported.
Does LibreTranslate always require an API key?
No. API key requirements depend on the configured LibreTranslate endpoint.
Why is website translation not working?
Common causes include invalid credentials, quota limits, disabled APIs, connectivity issues, and unsupported language pairs.
Does website translation guarantee accessibility compliance?
No. Translation can improve language access, but websites still need appropriate accessibility design and testing.
