Overview #
TranslatePress provides visual front-end translation for WordPress content, theme text, plugin strings, and dynamic pages. Premium features add capabilities such as additional languages, translator roles, navigation controls, and SEO-focused multilingual support depending on the licensed edition.
When to use it. Use it when editors need to translate the rendered site in context and maintain multilingual URLs, menus, metadata, and visitor language selection.
Before You Begin #
Platform compatibility. Use a WordPress and PHP combination supported by the current developer release. Minimum versions can change; verify the current official product page or plugin/theme metadata before production deployment. Do not bypass an activation or compatibility warning without identifying its cause.
Requirements and dependencies #
- – A supported WordPress site with administrator access.
- – A complete Database backup before changing translation plugins or URL structures.
- – A valid premium ZIP and license when developer-hosted updates or premium services are required.
- – Search-engine and cache configuration that supports multilingual URLs.
Pre-installation checks #
- – Inventory current languages, translated slugs, hreflang, sitemaps, menus, and translation data.
- – Do not run two front-end translation systems on the same content without a migration plan.
- – Test the intended default language and URL structure on staging.
Installation #
- 1. Go to Plugins > Add New Plugin > Upload Plugin.
- 2. Upload the current TranslatePress premium ZIP, install, and activate it.
- 3. If upgrading from an older premium package, follow the official edition-specific instructions; replacing the old premium plugin should not delete translations stored in the Database, but a backup is required.
- Open Settings > TranslatePress and configure languages and the language switcher.
- Activate only the premium add-ons required by the project.
License Activation #
- 1. Open Settings > TranslatePress > License on the main site and enter a valid key. (First, check whether the Pro version is already active, as manual license entry may not be required.)
- 2. Activate and verify the license. On multisite, use the location specified by current TranslatePress documentation rather than assuming the Network Admin screen.
- 3. The archive alone does not grant a Cozmoslabs account or vendor support.
Important. A premium download does not automatically establish ownership of the original developer’s account, license key, automatic-update service, cloud features, or direct support. Use only Credentials that are valid for this site and were supplied through an authorized account or an explicit Nippy Launch entitlement.
Initial Setup #
- 1. Set the default language only after confirming the site’s original content language.
- 2. Add target languages and choose the desired URL/switcher behavior.
- 3. Open Translate Site and translate a representative page, menu, form, and dynamic element.
- 4. Configure multilingual SEO features when included, then verify titles, descriptions, canonical URLs, hreflang, and sitemaps.
- 5. Clear caches and test logged-out language switching.
Recommended Configuration #
- – Translate global navigation, forms, validation messages, checkout, emails, and account screens—not just pages.
- – Use human review for legal, payment, and high-conversion content even if automatic translation is enabled.
- – Choose one stable URL strategy before indexing and avoid changing the default language casually.
- – Exclude translator and editor interfaces from public caching when necessary.
- – Monitor untranslated strings after theme or plugin updates.
Main Features #
The installed edition can provide the following primary capabilities. Availability may depend on the active plan, add-ons, and current release.
- – Visual front-end translation
- – String and dynamic-content translation
- – Language switchers
- – Multiple-language and translator workflows
- – Multilingual SEO features in applicable premium editions
How to Use It #
Practical starting workflow. Add one target language, translate the home page and primary menu, then test a form submission and WooCommerce checkout in that language. Inspect the source or an SEO crawler for correct canonical and hreflang output before expanding the translation set.
Integrations #
- – WooCommerce
- – Page builders and theme-rendered content
- – SEO plugins supported by TranslatePress
- – Automatic translation APIs when configured with the required external Credentials
Enable an integration only after its account ownership, permissions, data flow, and failure behavior have been tested. Keep secret Credentials out of page content and screenshots.
Common Issues & Troubleshooting #
- – Translate Site editor does not load. Clear caches, test a default theme, disable conflicting optimization on staging, and inspect browser errors.
- – Text cannot be selected. Check whether it is generated in an iframe, script, email, or unsupported context and consult the official string-translation guidance.
- – Language URL returns 404. Resave permalinks and review language URL settings and server rewrites.
- – Wrong language is cached. Configure page cache and CDN variation by language URL/cookie as required.
- – License is inactive. Verify the key, Domain, edition, and site-level license screen.
If the problem persists, reproduce it on staging, capture the exact error and relevant logs, and compare the behavior with nonessential plugins temporarily disabled. Restore the production site rather than troubleshooting destructively in place.
Updating the Plugin or Resource #
- 1. Back up translations and test updates on staging.
- 2. After updating, inspect the visual editor, language switcher, translated URLs, forms, checkout, metadata, hreflang, and sitemap.
- 3. When replacing an old premium edition, follow the current official sequence rather than keeping duplicate premium plugins.
- – Confirm that the backup completed and can be accessed independently of WordPress.
- – Review the official changelog and compatibility notes.
- – Update during a low-risk window and keep a tested rollback path.
- – Clear relevant caches and perform the product-specific functional tests listed above.
Uninstallation #
- 1. Export or back up the Database before removal because translation data is Database-based.
- 2. Plan redirects and indexation before removing languages or changing multilingual URL structures.
- 3. Confirm whether stored translations should remain before using any data-deletion option.
Deactivation and deletion are not the same as data removal. Confirm the product’s current cleanup options, Database tables, uploaded files, remote data, connected accounts, and continuing external billing or scheduled actions before removal.
Security & Best Practices #
- – Protect translation API keys and translator accounts.
- – Use least-privilege translator roles.
- – Review translated privacy, consent, legal, and transactional content.
- – Do not expose draft languages to search engines until they are complete.
- – Use unique administrator accounts, least-privilege roles, HTTPS, and multi-factor authentication where supported.
- – Keep the resource, WordPress, PHP, theme, and dependencies on supported versions.
- – Store backups and recovery instructions outside the WordPress site.
Final Checklist #
- ✅The correct resource and developer identity were confirmed.
- ✅A restorable backup was created before installation or major configuration.
- ✅All required core plugins, themes, services, and accounts are active.
- ✅The resource is installed and activated without WordPress or PHP errors.
- ✅A valid developer license is connected when one is required and available.
- ✅The product-specific initial and recommended settings are complete.
- ✅The practical workflow was tested as an administrator and as the intended visitor/customer/member.
- ✅Email, payments, webhooks, cron, cache, and integrations were tested where applicable.
- ✅Security, privacy, consent, data retention, and access rules were reviewed.
- ✅The update and rollback process is documented and owned by a named administrator.
