> For the complete documentation index, see [llms.txt](https://developers.weglot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.weglot.com/wordpress/plugin-settings.md).

# Plugin settings

## Plugin settings

Once the plugin is set up, a few built-in options let you fine-tune **what** gets translated and **how** the language switcher looks. You'll find them in the plugin's **Advanced** and **Appearance** tabs.

### Translate emails

When enabled, Weglot translates the emails sent by WordPress (through the `wp_mail` function) — both the **subject** and the **body** — into the language of the visitor who triggered them. Typical examples are a WooCommerce order confirmation or a contact-form notification sent to your customer.

The visitor's language is detected from the current request, or from the page they were on when the email was sent.

{% hint style="info" %}
Emails sent to your **site admin address are not translated** by default — they stay in your original language, which is usually what you want for internal notifications.
{% endhint %}

### Translate search

When enabled, your visitors can search your site in their own language. Weglot translates their search term back into your original language, runs the WordPress search on your original content, and returns the results translated.

This means you don't need to store translated content in your database for search to work.

### Exclude URLs

By default, every page of your site is translated. Use **Exclude URLs** to leave some pages untranslated. Rules are managed from your Weglot dashboard and support several matching modes:

* **Contains** — the path contains a given text (default)
* **Is exactly** — the path matches exactly
* **Starts with** / **Ends with**
* **Matches regex** — for advanced patterns

For example, to translate **only your homepage** (exclude every path except `/`), use a "Matches regex" rule with: `[^/]`

{% hint style="info" %}
Rules are matched against the URL **path** only — the query string (everything after `?`) is ignored.
{% endhint %}

### Exclude blocks

Sometimes you want to keep part of a page untranslated — a customer-review area, a code snippet, a brand name. With **Exclude blocks** you provide a CSS selector, and Weglot adds a `data-wg-notranslate` attribute to the matching element. Everything inside it is left as-is.

For example, excluding `.product-description` produces:

```markup
<h1 class="product-title">Mon super article</h1> <!-- translated -->
<p class="product-description" data-wg-notranslate>My awesome article</p> <!-- not translated -->
```

### Language switcher

Weglot adds a language button to your site. From the **Appearance** tab you can customize how it looks:

* **Dropdown or inline** — show the languages in a dropdown menu or side by side
* **With flags** — show a flag next to each language, and choose its shape: rectangle (mat or shiny), square or circle
* **With name** — show the language name, either its full local name (e.g. *Français*) or its ISO code (e.g. *FR*)
* **Custom CSS** — override the switcher's styling with your own rules

#### Positioning the switcher

You can place the language button wherever you want:

* **Default** — automatically added at the bottom-right of every page
* **In a menu** — add a "Weglot Translate" item from *Appearance → Menus*
* **In a widget area** — from *Appearance → Widgets*
* **Anywhere via shortcode** — drop `[weglot_switcher]` into a page, post or template
