What is WPML?
WPML is a plugin that extends WordPress to handle multiple languages on a single installation. It integrates with the WordPress editing interface, allowing you to assign a language to each post, page, or custom post type and then translate the content into additional languages. The plugin manages language-specific URLs, ensures that the correct version is displayed to each visitor, and provides tools for translating both content and interface strings.
Installation and activation
WPML can be obtained from the official website or from the WordPress plugin repository. After downloading the plugin, upload the zip file to the /wp-content/plugins/ directory, then activate it from the Plugins screen. Once activated, a new menu called WPML appears in the WordPress admin area, where you can start configuring languages and licenses.
The basic installation follows these steps:
- Download the WPML package or install it from the plugins page.
- Upload the plugin folder to the /wp-content/plugins/ directory.
- Activate WPML from the Plugins list.
- Enter your license key to enable updates and support.
Configuring languages
After activation, you can add the languages you need. WPML supports a wide range of languages, and you can also define custom language codes if necessary. Each language receives a unique slug, which is used in the site’s URLs. A language switcher widget or shortcode can be placed anywhere on the site to let visitors choose their preferred language.
Translating posts and pages
When you create a new post or page, a language selector appears in the publish meta box. After you choose a language and save the entry, a translation button becomes available. Clicking this button opens the translation editor, where you can enter the translated text. The editor shows the original content on the left and a blank field on the right, and it supports the same visual editing options as the standard WordPress editor.
Custom post types and taxonomies
WPML can translate custom post types, but they must be marked as translatable. In the WPML settings, you can enable translation for each custom post type and for taxonomies such as categories, tags, or custom terms. Once enabled, the translation workflow for these elements mirrors the one used for standard posts and pages.
Translation editor
The translation editor provides a side-by-side view of the original and the target language. It includes a rich text toolbar, allowing you to apply formatting, insert links, and add media. You can also use the “Copy from original” button to quickly duplicate the content and then edit it, which is useful for repetitive elements like headings or bullet points.
String translation
Beyond content, WPML can translate strings that appear in your theme or plugins. The String Translation panel lets you search for text such as menu labels, button text, or widget titles, and provide translations for each language. This ensures that the user interface feels consistent across all language versions.
Shortcodes and embedded content
Many WordPress sites use shortcodes to embed videos, galleries, or custom elements. WPML does not automatically translate the content inside shortcodes, so you may need to manually adjust the translated text or use a shortcode that accepts language-specific parameters. If you rely on a third-party plugin for embedding, check whether it offers multilingual support or provides a way to separate content per language.
Media and URL translation
Images and other media files can be translated by creating separate copies for each language. WPML includes a Media Translation add-on that copies the media library and updates references in posts. Additionally, you can enable slug translation so that the URL structure reflects the target language, which helps with search engine visibility and user experience.
Workflow and collaboration
WPML supports multiple translators. You can assign translation tasks to specific users, set deadlines, and track progress. The Translation Management panel provides an overview of all pending translations, making it easier to coordinate a team. For larger projects, you can integrate with external translation services or use the API to automate parts of the workflow.
Troubleshooting common issues
Sometimes translations do not appear on the front end. This can be caused by caching plugins, incorrect language assignments, or missing translation for a specific string. Clearing the cache and verifying that the correct language is selected in the URL usually resolves the problem. If a custom post type is not showing translations, double-check that it is marked as translatable in the WPML settings.
Best practices for maintaining translations
Keep your original content up to date. When you edit a post, WPML will flag it as needing translation. Review the translation after each update to ensure consistency. Use the same terminology across your site by maintaining a glossary, and consider using the Translation Editor’s “Copy from original” feature for repetitive elements. Regularly audit your language switcher to make sure all active languages are accessible.
Frequently Asked Questions (FAQs)
How do I install WPML?
You can install WPML by downloading the plugin from the official site or from the WordPress plugin repository. After uploading the zip file to the /wp-content/plugins/ directory, activate it from the Plugins screen and enter your license key to enable updates and support.
Can I translate custom post types?
Yes, WPML can translate custom post types, but they must be marked as translatable. In the WPML settings, enable translation for each custom post type and for any associated taxonomies. Once enabled, the translation workflow for these elements is the same as for standard posts and pages.
What is the difference between the Translation Editor and String Translation?
The Translation Editor is used for translating the content of posts, pages, and custom post types, providing a side-by-side view of the original and the target language. String Translation, on the other hand, is designed for translating UI elements such as menu labels, button text, and widget titles that appear in your theme or plugins.
How can I translate media files?
WPML offers a Media Translation add-on that creates separate copies of images, videos, and other media for each language. After enabling the add-on, you can translate the media library and update references in your content, ensuring that each language version displays the appropriate media.
Is it possible to translate URL slugs?
Yes, WPML includes a slug translation feature. When enabled, the URL structure for each language reflects the translated slug, which can improve both user experience and search engine visibility. You can configure this in the WPML settings under the “Slug translation” section.
What should I do if a translation is missing?
If a translation is missing, first check that the post or page is assigned to the correct language and that the translation has been saved. Clear any caching plugins and verify that the language switcher is working. If the issue persists, review the WPML settings to ensure the relevant content type is marked as translatable.
