WPML

To change the wpml-config.xml that WPML serves for your theme or plugin, send it to the WPML Compatibility team. The GitHub repository is archived.

What wpml-config.xml Files Are

A wpml-config.xml file is WPML's instructions for translating a theme's or plugin's content. It tells WPML which custom fields, post types, taxonomies and admin texts to translate. For example, it can tell WPML to translate a slider's caption field.

For many themes and plugins, WPML serves such a file to every WPML site. WPML merges it into its own configuration, so clients get the right translation settings without any setup.

Where the wpml-config.xml Files Live Now

Since November 2, 2026, the files that WPML serves live in WPML's own repository. The WPML Compatibility team maintains them.

Before that, they lived in the public wpml-config repository on GitHub, where authors opened pull requests.

How to Contribute a Change to Your wpml-config.xml

Changes go through the Go Global program, WPML's compatibility program for theme and plugin authors.

  1. Prepare the file or the change. Write the complete wpml-config.xml for your product, or list the lines you want to add, change or remove.
  2. Open the Go Global form. Go to the Go Global application form for theme and plugin authors and fill in your name, your email and your product's details.
  3. Add the file or the change. Paste it into the Additional information field and click Send my application.
  4. Wait for the review. The WPML Compatibility team reviews your file, validates it and publishes it. This usually takes a few days.

Shipping Your Own wpml-config.xml Needs No Submission

You can also put a wpml-config.xml file in the root folder of your theme or plugin. WPML reads it on every site that runs your product. You update it in your own releases, and you do not need to send it to us.

Read how to write the file in the WPML language configuration file guide.

The GitHub wpml-config Repository Is Archived

The wpml-config repository on GitHub is archived. You can still read it, but it no longer accepts pull requests or changes. Its README points to this page.

Pull requests that were still open there will not be merged. To keep such a change, send it through the Go Global form.

Written byAmir