`,
`` and `--publish`.
**12. Format the code**
```bash Terminal theme={"dark"}
vendor/bin/pint
```
**Why:** Pint applies Laravel's code style to every file you added.
## Run it
**1. Translate**
Give the language's code and its name as its speakers write it:
```bash Terminal theme={"dark"}
php artisan site:translate fr "Français"
```
**You should see**, after a few seconds per document (the cost and tokens are the model's, so
yours will read differently):
```text Terminal theme={"dark"}
INFO Added Français (fr) to the site, not public yet.
+---------------+----------------------------------+-----------------------------------------------------------------------------------------+
| | Document | Preview |
+---------------+----------------------------------+-----------------------------------------------------------------------------------------+
| page | Home | https://acme.example/fr/?aposShareKey=…&aposShareId=… |
| page | About us | https://acme.example/fr/about-us?aposShareKey=…&aposShareId=… |
| page | Services | https://acme.example/fr/services?aposShareKey=…&aposShareId=… |
| page | Contact us | https://acme.example/fr/contact-us?aposShareKey=…&aposShareId=… |
| blog post | Now open on Saturday mornings | https://acme.example/fr/blog/now-open-on-saturday-mornings?aposShareKey=…&aposShareId=… |
| FAQ | When are you open? | Submitted Drafts in the CMS |
| FAQ | Do I need to book? | Submitted Drafts in the CMS |
| site settings | Header, footer and cookie banner | Submitted Drafts in the CMS |
| shown on them | Contact form | Submitted Drafts in the CMS |
| shown on them | Jordan Lee | Submitted Drafts in the CMS |
| shown on them | News | Submitted Drafts in the CMS |
+---------------+----------------------------------+-----------------------------------------------------------------------------------------+
INFO 11 translated, 0 not, 0 already up to date.
INFO Tokens: 45380 in, 10860 out. Cost: $0.3150.
```
Pages and blog posts get a preview link. FAQs and what the pages show have no page of their
own: they are in **Submitted Drafts**.
**2. Read the drafts**
Open a **Preview** link: it is the translated page as visitors will see it, with no sign-in,
even while the language is private. Send it only to the people reviewing it.
Your header, footer and cookie banner are one draft, **Header, footer and cookie banner** in
**Submitted Drafts**. Their links to your pages already point at the pages in the new language
(`/about-us` becomes `/fr/about-us`); links to other sites stay as they are.
**3. Publish them**
Sign in to the CMS, press **⌘K**, type `Submitted Drafts` and press **Enter**. Open each
translation, change anything you like, and click **Publish**. Not happy with one? Dismiss it
there: it stays an unpublished draft.
**4. Put the language live**
```bash Terminal theme={"dark"}
php artisan site:translate fr "Français" --publish
```
It makes the language public, translates anything new or changed (as drafts, as always), and
ends:
```text Terminal theme={"dark"}
INFO 0 translated, 0 not, 11 already up to date.
INFO Tokens: 0 in, 0 out. Cost: $0.0000.
SUCCESS Français is public: visitors see each page you have published in it.
```
Visitors now get a language switcher in your site's header. A page you haven't published in
French isn't there in French.
**5. Keep it current**
Run the same command after you change your site. Only what changed is translated again, and its
new draft goes back to **Submitted Drafts**.
## If something goes wrong
> [accordion] … isn't a language code
>
> Use a lowercase code, such as `fr`, or a language and a country, such as `pt-br`. Put the name in
> quotes when it has a space: `"Português (Brasil)"`.
> [accordion] ERROR Site … answered PATCH /api/v1/site-languages/… with 400 invalid
>
> The site refused the new language, and the end of the line says why:
>
> * `“en” is the main language’s code`: that code is your main language's. Give the new language
> its own.
> * `“/api” is already one of the site’s own addresses`: some codes are taken by your site's own
> addresses. Choose a different code.
>
> Nothing was added or copied. Run the command again with another code.
> [accordion] An error naming a scope
>
> The key lacks that scope: the run stopped before it overwrote anything. Add the scope to the key
> under **API Keys** (a page that shows a kind of document missing from the table above, such as a
> team member, needs that kind's `content:…:write` too), then run the command again.
> [accordion] HTTP request returned status code 401: … User not found.
>
> OpenRouter refused `OPENROUTER_API_KEY`. Copy the key again from
> [openrouter.ai/settings/keys](https://openrouter.ai/settings/keys); it starts with `sk-or-v1-`.
> The documents copied before the error are translated on the next run.
> [accordion] Not saved: … in the table
>
> The agent's answer didn't pass the checks in `attempts` calls, and the words after `Not saved:`
> are the problems left. The draft is the untouched copy. Run the command again to retry just that
> one; if a name keeps changing, add it to `glossary` in `config/site-translate.php`.
> [accordion] Not translated: the run reached \$10
>
> The run's budget is spent. Everything before it is saved: run the command again to go on, or
> raise `max_cost_per_run_usd` in `config/site-translate.php`.
> [accordion] Not translated: the model didn't answer (…)
>
> Every attempt at that document failed: the words in brackets say how (a timeout, an outage, a
> rate limit). The other documents went on, and this one's draft is the untouched copy. Run the
> command again to translate just that one. If it keeps timing out on a long page, raise
> `timeout_seconds` in `config/site-translate.php`.
> [accordion] Composer answers 401 Unauthorized
>
> Your site refused the key in `auth.json`: it's mistyped or cut short, switched off, or past its
> **Expires** date. Run the `composer config bearer…` line again with the whole key.
## Test it
The tests fake both sides. `FakeSite` keeps the site's documents in memory and answers the routes the
translator calls, on top of `Attract::fake()`, which answers every SDK method and records it.
`Translator::fake()` answers for the model: so the real translator runs, with the real checks, and
nothing is sent or spent.
**1. Remove the starter tests**
```bash Terminal theme={"dark"}
rm tests/Unit/ExampleTest.php tests/Feature/ExampleTest.php
```
**2. The fake site**
```php tests/FakeSite.php theme={"dark"}
:`
* (`$stored` starts as the main language's): `request()` answers the routes
* the translator calls (list, get, localize, PATCH, submit) from them, and the
* SDK's methods answer as `Attract::fake()` does, from `$answers`, over a site
* with English and a private French. `$log` lists each copy and write, in
* order. Ids are 10 characters or more, as the site's are, which tells them
* from a type's name.
*/
class FakeSite
{
/** @var array> */
public array $docs = [];
/** @var list Each copy and write, in order: "copy to fr", "write in fr". */
public array $log = [];
/**
* @param list> $stored
* @param array $answers
*/
public function __construct(array $stored, array $answers = [])
{
foreach ($stored as $doc) {
$this->docs["{$doc['aposDocId']}:en"] = $doc;
}
Attract::fake([
'languages.listSiteLanguages' => [
'results' => [SiteLanguages::factory()->make(['id' => 'langs', 'languages' => []])],
'pages' => 1,
'currentPage' => 1,
],
'internationalization.getLocales' => [
'en' => ['label' => 'English'],
'fr' => ['label' => 'Français', 'prefix' => '/fr', 'private' => true],
],
'languages.getGlobalTranslatedFields' => ['translated' => ['tagline', 'headerNav', 'footerLinkGroups']],
'pages.sharePage' => Page::factory()->make(['aposShareKey' => 'share-key']),
'blogPosts.shareBlog' => Blog::factory()->make(['aposShareKey' => 'share-key']),
...$answers,
'request' => fn (array $args) => $this->route(...$args),
]);
}
/** @param array $query */
private function route(string $method, string $path, array $query, mixed $body): mixed
{
preg_match('#^/(.+?)(?:/([a-z0-9]{10,})(?::[a-z-]+:draft)?)?(?:/(localize|submit))?$#', $path, $match);
[, $type, $id, $action] = $match + [null, null, null, null];
$locale = $query['aposLocale'] ?? '';
if ($method === 'GET' && ! $id) {
$results = array_values(array_filter(
$this->docs,
fn (array $doc, string $key): bool => str_ends_with($key, ":{$locale}") && $this->typeOf($doc) === $type,
ARRAY_FILTER_USE_BOTH,
));
return ['results' => $results, 'pages' => 1];
}
if ($method === 'GET') {
return $this->docs["{$id}:{$locale}"] ?? Attract::notFound();
}
if ($action === 'localize') {
$to = $body['toLocale'];
if (isset($this->docs["{$id}:{$to}"]) && ! $body['update']) {
return Attract::siteError(409);
}
$this->log[] = "copy {$id} to {$to}";
$at = now()->toISOString();
$original = $this->docs["{$id}:en"];
$this->docs["{$id}:{$to}"] = [
...$original,
...(isset($original['_url']) ? ['_url' => str_replace('.example/', ".example/{$to}/", $original['_url'])] : []),
'_id' => "{$id}:{$to}:draft",
'updatedAt' => $at,
'localizedAt' => $at,
];
return [];
}
if ($method === 'PATCH') {
$this->log[] = "write {$id} in {$locale}";
$this->docs["{$id}:{$locale}"] = [
...$this->docs["{$id}:{$locale}"],
...$body,
'updatedAt' => now()->addSecond()->toISOString(),
];
return $this->docs["{$id}:{$locale}"];
}
return [];
}
/** @param array $doc */
private function typeOf(array $doc): string
{
return str_starts_with($doc['slug'] ?? '', '/') ? '@apostrophecms/page' : $doc['type'];
}
}
```
**Why:** `Attract::fake()` takes a closure for `request`, called with each call's method, path,
query and body, so one small router stands in for the site's routes. A conflict answers with
`Attract::siteError(409)`, as the site does when a copy is already there.
**3. The wording's tests**
```php tests/Unit/WordingTest.php theme={"dark"}
'aboutpage01:en:draft',
'aposDocId' => 'aboutpage01',
'type' => 'default-page',
'slug' => '/about',
'title' => 'About us',
'seoDescription' => 'Who we are',
'sections' => [
'metaType' => 'area',
'items' => [
[
'_id' => 'herowidget1',
'metaType' => 'widget',
'type' => 'hero',
'heroHeadline' => 'Welcome in',
'heroEyebrowPlacement' => 'belowHeadline',
'heroPrimaryCtaUrl' => 'https://acme.example/book',
'heroBg' => 'raised',
'heroIcon' => 'arrow-right',
'heroImage' => [
'metaType' => 'area',
'items' => [
[
'_id' => 'imagewidget',
'metaType' => 'widget',
'type' => '@apostrophecms/image',
'linkTo' => '@apostrophecms/any-page-type',
'_image' => [
[
'_id' => 'photo000001:en:draft',
'type' => '@apostrophecms/image',
'metaType' => 'doc',
'slug' => 'image-shop',
'title' => 'Shop',
],
],
],
],
],
],
[
'_id' => 'textwidget1',
'metaType' => 'widget',
'type' => '@apostrophecms/rich-text',
'content' => 'We answer fast.
',
],
],
],
'_author' => [['_id' => 'author00001:en:draft', 'type' => 'author', 'metaType' => 'doc', 'title' => 'Jordan']],
'_ancestors' => [['_id' => 'homepage001:en:draft', 'type' => 'home-page', 'metaType' => 'doc', 'slug' => '/']],
'_folder' => [['_id' => 'folder00001', 'type' => 'image-folder', 'metaType' => 'doc']],
'updatedBy' => ['title' => 'Jordan Lee', 'username' => 'jordan'],
];
test('the wording is the words a visitor reads, under the keys PATCH writes them back by', function () {
expect(Wording::of(PAGE))->toBe([
['key' => 'title', 'text' => 'About us'],
['key' => 'seoDescription', 'text' => 'Who we are'],
['key' => '@herowidget1.heroHeadline', 'text' => 'Welcome in'],
['key' => '@textwidget1.content', 'text' => 'We answer fast.
'],
]);
});
test('what a page shows leaves out pages and a folder shared by every language', function () {
expect(array_column(SiteDocuments::related(PAGE), 'aposDocId'))->toBe(['photo000001', 'author00001']);
});
test('a translation that keeps keys, tags, links and names passes', function () {
$original = [
['key' => 'title', 'text' => 'About Acme'],
['key' => '@t.content', 'text' => 'We answer fast.
'],
];
$translated = [
['key' => 'title', 'text' => 'À propos de Acme'],
['key' => '@t.content', 'text' => 'Nous répondons vite.
'],
];
expect(Wording::problems($original, $translated, ['Acme']))->toBe([]);
});
test('every problem with a translation is named', function () {
$original = [
['key' => 'title', 'text' => 'About Acme'],
['key' => '@t.content', 'text' => 'We answer fast.
'],
];
$translated = [
['key' => 'title', 'text' => 'À propos d’Akmé'],
['key' => '@t.content', 'text' => 'Nous répondons vite.
'],
['key' => 'slug', 'text' => 'a-propos'],
];
expect(Wording::problems($original, $translated, ['Acme']))->toBe([
'title: "Acme" is in the glossary. Keep it exactly as written.',
'@t.content: the HTML tags changed. Keep exactly these, in order: p a /a /p.',
'@t.content: a link changed. Keep every href and src exactly as it was.',
'slug: not one of the keys you were given. Leave it out.',
]);
});
test('a sentence sent back as it was is named; a short label, a name or an address may stay', function () {
$original = [
['key' => 'title', 'text' => 'Marketing'],
['key' => 'note', 'text' => 'Acme Outfitters'],
['key' => 'address', 'text' => 'Mill Valley, New York'],
['key' => '@t.content', 'text' => 'Is a bath included with my stay?
'],
];
$translated = [
['key' => 'title', 'text' => 'Marketing'],
['key' => 'note', 'text' => 'Acme Outfitters'],
['key' => 'address', 'text' => 'Mill Valley, New York'],
['key' => '@t.content', 'text' => 'Is a bath included with my stay?
'],
];
expect(Wording::problems($original, $translated, ['Acme Outfitters']))->toBe([
'@t.content: still in the original language. Translate it.',
]);
});
test('a {placeholder} the site fills in must come back as it was, in any order', function () {
$original = [
['key' => 'footerCopyrightText', 'text' => '© {year} {business}. All rights reserved.'],
['key' => 'footerNote', 'text' => 'Since {year}'],
];
$translated = [
['key' => 'footerCopyrightText', 'text' => '{business} © {year}. Tous droits réservés.'],
['key' => 'footerNote', 'text' => 'Depuis {année}'],
];
expect(Wording::problems($original, $translated, []))->toBe([
'footerNote: keep these exactly as written, the site fills them in: {year}.',
]);
});
```
**4. The translator's tests**
```php tests/Feature/SiteTranslatorTest.php theme={"dark"}
'homepage001:en:draft',
'aposDocId' => 'homepage001',
'type' => 'home-page',
'slug' => '/',
'title' => 'Home',
'level' => 0,
'updatedAt' => OLD,
'_url' => 'https://acme.example/',
'sections' => [
'metaType' => 'area',
'items' => [
[
'_id' => 'herowidget1',
'metaType' => 'widget',
'type' => 'hero',
'heroHeadline' => 'Welcome to Acme',
'heroImage' => [
'metaType' => 'area',
'items' => [
[
'_id' => 'imagewidget',
'metaType' => 'widget',
'type' => '@apostrophecms/image',
'_image' => [
['_id' => 'photo000001:en:draft', 'type' => '@apostrophecms/image', 'metaType' => 'doc', 'slug' => 'image-shop'],
],
],
],
],
],
],
],
];
const PHOTO = [
'_id' => 'photo000001:en:draft',
'aposDocId' => 'photo000001',
'type' => '@apostrophecms/image',
'slug' => 'image-shop',
'title' => 'Shop',
'updatedAt' => OLD,
];
const FAQ = [
'_id' => 'faqitem0001:en:draft',
'aposDocId' => 'faqitem0001',
'type' => 'faq-item',
'slug' => 'hours',
'title' => 'When are you open?',
'updatedAt' => OLD,
];
/**
* A fake translator: it answers every text it is given with "[fr]" in front of its words
* (tags and links kept), and OpenRouter's cost of $0.002 in its raw answer.
*/
function translateWithFrPrefix(): void
{
Translator::fake(function (string $prompt): TextResponse {
$texts = array_map(fn (array $item): array => [
'key' => $item['key'],
// Mark the words, never the tags: "Hi
" → "[fr] Hi
".
'text' => preg_replace('/(^|>)([^<]*\p{L}[^<]*)/u', '$1[fr] $2', $item['text'], 1),
], json_decode($prompt, true)['texts']);
$response = new StructuredTextResponse(['texts' => $texts], '', new TextUsage(1000, 200), new Meta);
return $response->withRawResponse(new Response(new Psr7Response(200, [], '{"usage":{"cost":0.002}}')));
});
}
test('it adds the language, copies what pages show first, and writes only drafts', function () {
$site = new FakeSite([HOME, PHOTO, FAQ]);
translateWithFrPrefix();
$report = app(SiteTranslator::class)->translate('fr', 'Français');
expect($report->added)->toBeTrue();
Attract::assertCalled('languages.updateSiteLanguages', fn (array $args) => $args['languages']->toArray() === [
['name' => 'Français', 'code' => 'fr', 'public' => false],
]);
// The photo is copied into French before the page that shows it is written.
expect($site->log)->toBe([
'copy photo000001 to fr',
'copy homepage001 to fr',
'copy faqitem0001 to fr',
'write homepage001 in fr',
'write faqitem0001 in fr',
]);
expect($site->docs['homepage001:fr']['@herowidget1.heroHeadline'])->toBe('[fr] Welcome to Acme')
->and($site->docs['faqitem0001:fr']['title'])->toBe('[fr] When are you open?');
expect(array_map(fn ($doc) => [$doc->title, $doc->problem], $report->documents))->toBe([
['Home', null],
['When are you open?', null],
]);
expect($report->documents[0]->previewUrl)
->toBe('https://acme.example/fr/?aposShareKey=share-key&aposShareId=homepage001%3Afr%3Adraft');
expect($report->inputTokens)->toBe(2000)
->and($report->costUsd)->toEqualWithDelta(0.004, 1e-9);
Attract::assertNotCalled('pages.publishPage');
});
test('a translation already up to date is never redone', function () {
$site = new FakeSite([FAQ]);
$site->docs['faqitem0001:fr'] = [...FAQ, 'localizedAt' => '2026-02-01T00:00:00.000Z', 'updatedAt' => '2026-02-02T00:00:00.000Z'];
Translator::fake()->preventStrayPrompts();
$report = app(SiteTranslator::class)->translate('fr', 'Français');
expect($report->upToDate)->toBe(1)
->and($report->documents)->toBe([]);
Translator::assertNeverPrompted();
});
test('a copy a stopped run left untranslated is translated by the next run', function () {
$category = [
'_id' => 'category001:en:draft',
'aposDocId' => 'category001',
'type' => 'faq-category',
'slug' => 'visiting',
'title' => 'Visiting',
'updatedAt' => OLD,
];
$faq = [...FAQ, '_category' => [['_id' => 'category001:en:draft', 'type' => 'faq-category', 'metaType' => 'doc']]];
$site = new FakeSite([$faq, $category]);
// The last run translated the FAQ, copied its category, then stopped before writing its words.
$site->docs['faqitem0001:fr'] = [...$faq, 'localizedAt' => '2026-02-01T00:00:00.000Z', 'updatedAt' => '2026-02-02T00:00:00.000Z'];
$site->docs['category001:fr'] = [...$category, 'localizedAt' => OLD, 'updatedAt' => OLD];
translateWithFrPrefix();
$report = app(SiteTranslator::class)->translate('fr', 'Français');
expect($site->log)->toBe(['copy category001 to fr', 'write category001 in fr'])
->and($site->docs['category001:fr']['title'])->toBe('[fr] Visiting')
->and($report->upToDate)->toBe(1);
});
test('it translates the header, footer and cookie banner, their links pointed at the pages in the language', function () {
$about = [
'_id' => 'aboutpage01:en:draft',
'aposDocId' => 'aboutpage01',
'type' => 'default-page',
'slug' => '/about-us',
'title' => 'About us',
'level' => 1,
'updatedAt' => OLD,
'_url' => 'https://acme.example/about-us',
];
$settings = [
'_id' => 'settings001:en:draft',
'aposDocId' => 'settings001',
'type' => '@apostrophecms/global',
'slug' => 'global',
'updatedAt' => OLD,
'businessName' => 'Acme',
'fontDisplay' => 'Cabinet Grotesk',
'tagline' => 'Open every day',
'headerNav' => [
['_id' => 'navrow00001', 'label' => 'About us', 'url' => '/about-us', 'placement' => 'more'],
['_id' => 'navrow00002', 'label' => 'Book', 'url' => 'https://book.example/about-us'],
],
'footerLinkGroups' => [
[
'_id' => 'footgroup01',
'heading' => 'Explore',
'links' => [['_id' => 'footlink001', 'label' => 'Our hours', 'url' => '/about-us#hours']],
],
],
];
$site = new FakeSite([$about, $settings]);
translateWithFrPrefix();
$report = app(SiteTranslator::class)->translate('fr', 'Français');
$french = $site->docs['settings001:fr'];
// Only the words each language keeps its own copy of; never a shared setting.
expect($french['tagline'])->toBe('[fr] Open every day')
->and($french['@navrow00001.label'])->toBe('[fr] About us')
->and($french['@footlink001.label'])->toBe('[fr] Our hours')
->and($french['fontDisplay'])->toBe('Cabinet Grotesk')
->and($french['businessName'])->toBe('Acme');
// The links to a page here point at it in French; another site's link stays as it is.
expect($french['@navrow00001.url'])->toBe('/fr/about-us')
->and($french['@footlink001.url'])->toBe('/fr/about-us#hours')
->and($french)->not->toHaveKey('@navrow00002.url');
expect(array_map(fn ($doc) => [$doc->title, $doc->kind, $doc->problem], $report->documents))
->toContain(['Header, footer and cookie banner', 'site settings', null]);
});
test('a translation that keeps failing its checks is never written', function () {
$site = new FakeSite([FAQ]);
Translator::fake(fn () => ['texts' => []]);
$report = app(SiteTranslator::class)->translate('fr', 'Français');
expect($report->documents[0]->problem)->toBe('Not saved: title: missing. Translate every key you were given.')
->and($site->docs['faqitem0001:fr']['title'])->toBe('When are you open?'); // the copy, untouched
Translator::assertPrompted(fn ($prompt) => str_contains($prompt->prompt, '"problems"'));
});
test('a model call that fails is tried again', function () {
$site = new FakeSite([FAQ]);
$calls = 0;
Translator::fake(function (string $prompt) use (&$calls): array {
if (++$calls === 1) {
throw ProviderConnectionException::forProvider('openrouter');
}
return ['texts' => [['key' => 'title', 'text' => 'Quand êtes-vous ouverts ?']]];
});
$report = app(SiteTranslator::class)->translate('fr', 'Français');
expect($report->documents[0]->problem)->toBeNull()
->and($site->docs['faqitem0001:fr']['title'])->toBe('Quand êtes-vous ouverts ?');
});
test('a model that never answers leaves only that document to the next run', function () {
$site = new FakeSite([HOME, PHOTO, FAQ]);
Translator::fake(function (string $prompt): array {
$texts = json_decode($prompt, true)['texts'];
if ($texts[0]['text'] === 'When are you open?') {
throw ProviderConnectionException::forProvider('openrouter');
}
return ['texts' => array_map(fn (array $item): array => [...$item, 'text' => "[fr] {$item['text']}"], $texts)];
});
$report = app(SiteTranslator::class)->translate('fr', 'Français');
$problems = collect($report->documents)->mapWithKeys(fn ($doc) => [$doc->title => $doc->problem]);
expect($problems['When are you open?'])->toBe("Not translated: the model didn't answer (Could not connect to AI provider [openrouter]). Run it again to go on.")
->and($problems['Home'])->toBeNull()
->and($site->docs['faqitem0001:fr']['title'])->toBe('When are you open?'); // the copy, untouched
});
```
**Why:** the fake translator puts `[fr]` in front of the words, so a test can see what was
written, and gives each answer a raw OpenRouter body with its cost, as a real answer has.
**5. The command's tests**
```php tests/Feature/SiteTranslateCommandTest.php theme={"dark"}
artisan('site:translate', ['code' => 'French', 'name' => 'Français'])
->expectsOutputToContain("isn't a language code")
->assertFailed();
Attract::assertNothingCalled();
});
test('a scope the key lacks fails with the site’s own message', function () {
Attract::fake(['languages.listSiteLanguages' => Attract::forbidden()]);
Translator::fake()->preventStrayPrompts();
$this->artisan('site:translate', ['code' => 'fr', 'name' => 'Français'])
->expectsOutputToContain('forbidden')
->assertFailed();
});
```
**6. Run them**
```bash Terminal theme={"dark"}
php artisan test --compact
```
**You should see:**
```text Terminal theme={"dark"}
...............
Tests: 15 passed (44 assertions)
```
## Turn it off
> [card] Revoke the site key
>
> In the CMS, **⌘K** → `API Keys`, open **Translate the site**, and switch **Enabled** off (or
> delete it). The app's next call is refused.
> [card] Revoke the OpenRouter key
>
> Delete it at [openrouter.ai/settings/keys](https://openrouter.ai/settings/keys), then remove the lines
> you added to `.env`.
> [card] Take the language down
>
> **⌘K** → `Languages`, set its **Public** to **No** (visitors stop seeing it) or remove it. Its
> translations are kept: add the same code again and they come back.
> [card] Nothing runs on its own
>
> The command works only when you run it. Drafts it already made stay in the CMS until you publish or dismiss them.
## Related
> [card] [Your site in more than one language](https://docs.fetchski-attract.com/guides/build-pages/languages.md)
>
> Languages, translating by hand, and what changes for visitors
> [card] [Update the site's languages](https://docs.fetchski-attract.com/laravel/reference/languages/update-site-languages.md)
>
> The call that adds a language and makes it public
> [card] [Testing in Laravel](https://docs.fetchski-attract.com/laravel/testing.md)
>
> `Attract::fake()` and the assertions
> [card] [The same Recipe in AdonisJS](https://docs.fetchski-attract.com/recipes/adonis-agent-translate-your-site.md)
>
> An OpenRouter agent with one checked save tool
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.