---
title: "Shortcode & Blocks"
description: "Attributes for [shapetranslate_switcher] and the two switcher blocks."
url: "https://shapetranslate.com/docs/dev-shortcode/"
updated: "2026-11-16"
category: Developer Guide
---

# Shortcode & Blocks

Attributes for `[shapetranslate_switcher]` and the two switcher blocks.

## Shortcode

Shortcode

```
[shapetranslate_switcher layout="dropdown" show_flags="true" hide_current="true"]
```

| Attribute | Values | Default |
| --- | --- | --- |
| `display` | `native_name`, `name`, `language_code` | `native_name` |
| `layout` | `horizontal`, `vertical`, `dropdown` | `horizontal` |
| `unavailable_behavior` | `hide`, `disabled`, `home`, `current` | `hide` |
| `hide_current` | `true` / `false` | `false` |
| `hide_missing` | `true` / `false`. Wins over `unavailable_behavior`. | `false` |
| `show_flags` | `true` / `false` | `false` |
| `show_disabled` | `true` / `false` | `false` |
| `aria_label` | Text for screen readers | empty |
| `class` | Extra CSS class | empty |

Defaults shown are the plugin's own. The values saved under Settings → Switcher replace them site-wide.

## Blocks

- `shapetranslate/language-switcher`: attributes `display`, `layout`, `hideCurrent`, `hideMissing`, `unavailableBehavior`, `showFlags`, `showDisabled`, `ariaLabel`.
- `shapetranslate/navigation-language-switcher`: only inside `core/navigation`; adds `dropdown` (show as submenu).

Front-end CSS and JS handles: `shapetranslate-switcher`, `shapetranslate-floating-switcher`. The switcher markup has the class `shapetranslate-switcher`.
