Unlock the full potential of your decoupled WordPress architecture by seamlessly integrating multilingual capabilities with your GraphQL API. WPML GraphQL bridges the gap between the industry-standard WordPress Multilingual plugin (WPML) and WPGraphQL, empowering developers to build high-performance, localized headless applications without sacrificing the intuitive translation management tools your team already relies on.
Key Features
- Seamless Integration: Automatically exposes your WPML-translated content, including posts, pages, and custom post types, directly through your GraphQL schema.
- Translation Status Awareness: Easily query the translation status of your content, allowing your frontend to display only published translations or flag missing content for users.
- Language-Specific Queries: Effortlessly fetch content based on specific language codes, ensuring your headless application serves the correct localized version to every visitor.
- Support for Custom Fields: Works in tandem with popular page builders and custom field plugins, ensuring that translated metadata and complex field structures are correctly mapped in your API responses.
- Performance Focused: Built to minimize overhead, ensuring that your multilingual headless site remains fast and responsive even as your translation library grows.
- Developer-Friendly Schema: Follows standard GraphQL conventions, making it intuitive for frontend developers to navigate and retrieve localized data structures without complex workarounds.
Use Cases and Who It’s For
This plugin is designed for developers, agencies, and enterprise organizations that have moved beyond traditional WordPress themes to embrace headless or decoupled architectures. If your team uses WordPress as a robust content management system (CMS) but delivers content via React, Vue, Next.js, or mobile applications, you have likely encountered the challenge of serving that content in multiple languages.
WPML GraphQL is perfect for global brands that need to maintain a single source of truth for their content while providing localized experiences to international audiences. It is also an essential tool for agencies building complex, multi-site, or multi-language projects where the client demands the ease of the WPML interface for their editorial team, while the development team requires a clean, modern API for the frontend delivery.
Setup and How It Works
- Install Dependencies: Ensure that both the WPML core plugin and the WPGraphQL plugin are installed and active on your WordPress site.
- Activate the Bridge: Install and activate the WPML GraphQL plugin. No complex configuration is typically required to begin seeing localized data in your schema.
- Verify the Schema: Open your GraphQL IDE (such as GraphiQL) within the WordPress dashboard to inspect the new fields added to your queries. You will now see language-specific arguments available on your content nodes.
- Query Your Data: Update your frontend data-fetching logic to include the language parameter in your queries. You can now request content by specific language codes, allowing your application to switch between translations dynamically based on user preferences or browser settings.
Similar Plugins
While WPML GraphQL is the primary solution for bridging these two specific ecosystems, developers working in the headless space may also explore alternative approaches depending on their stack:
- Polylang for WPGraphQL: An alternative for teams that prefer the Polylang translation plugin over WPML, offering similar functionality for exposing localized content via the GraphQL API.
- Custom API Endpoints: For highly specialized use cases, some developers choose to write custom WPGraphQL extensions to map translation data manually, though this requires significantly more maintenance than using a dedicated bridge plugin.