You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Changing language from Spanish to English doesn't work #14409
Reacted by Felix Schneider, Jan Dudulski, Zhonghao Guo, Daniel Camarda, huangyc0618, Vyachean, Łukasz Rutkowski, Lorenzo Bonicelli, Alessandro Staffolani and dbul
If you check Chrome DevTools → Application → Cookies:
When oc_locale=en, the language selector works fine.
When oc_locale is set to something else (e.g. ko), switching to other non-English languages works.
However, switching to English does not work — it just redirects back to the ko docs.
So basically, if oc_locale is not en, I’m unable to view the English docs. It seems like the cookie is forcing a redirect back to the current locale when trying to switch to English.
I don't wanna pollute the issue, but I can confirm, this also happens when the preferred language is German in the browser. That way, it is not possible to view the original English documentation, even when switching with the language dropdown or adapting the URL. I think it should be possible to view the docs in a language different from the browser preferred one as translations might be out of date.
Same happens to me. I don't have oc_locale cookie, and my firefox has english set as preferred language. I guess it takes a preference from geolocation.
If anyone needs a quick fix to force the docs to be english, entering document.cookie = 'oc_locale=en; Path=/; Max-Age=31536000; SameSite=Lax' in the console seems to work around the issue.
Reacted by alexfertel, Jun, Ryan Vogel, Felix Schneider and Zhonghao Guo
Same happens to me. I don't have oc_locale cookie, and my firefox has english set as preferred language. I guess it takes a preference from geolocation.
It used to set oc_locale depending on preferred language.
If anyone needs a quick fix to force the docs to be english, entering document.cookie = 'oc_locale=en; Path=/; Max-Age=31536000; SameSite=Lax' in the console seems to work around the issue.
I want to chime in and express my disappointment about proliferating automatic translations! Don't do that. YouTube and Reddit has pionieered this confusing behavior, it just makes it difficult to use the docs, especially technical documentation.
If anything, consider showing the user an option to switch to their native language (but show the original content as default). Selecting a machine translation right away and making the user search for the language switcher button is just rude.
The translation for technical stuff is very brittle anyway- code and configuration options remain English, so you see a weird mix of languages.
Reacted by Nicolas K., chenmi, Jun, Daniel Camarda, Felix Schneider, Vyachean, Zhonghao Guo, G. Torreilles, Lorenzo Bonicelli, Cristian Gutiérrez and 4 more
Reacted by Jan Dudulski, Jun, G. Torreilles, dbul and Didier
Same issue here, trying to switch from Italian to English.
It looks to me that the https://opencode.ai/docs/ endpoint auto-detects the user's language, but specific language endpoints like https://opencode.ai/docs/it/ or https://opencode.ai/docs/es/ force the specified language.
I think an easy fix that wouldn't require changing much about how the website works would be to add a /docs/en/ endpoint that (like any other language) forces English, then update the language switcher URL to point to that endpoint instead of the root /docs/ which would keep acting as it does now with language auto-detection.
Besides the console method, another quick fix is to simply replace the language code in the URL to "en". For example, https://opencode.ai/docs/en/skills/.
Activity
github-actions commentedon Feb 20, 2026
This issue might be a duplicate of existing issues. Please check:
If your issue is the same, please consider adding a "+1" reaction or additional context there instead of opening a new issue.
Seungjun0906 commentedon Feb 20, 2026
@R44VC0RP
Hi Ryan!
could you check this PR!
#13608
R44VC0RP commentedon Feb 20, 2026
I'm not able to reproduce this when I go from English -> Spanish -> English. Can you provide more details?
Seungjun0906 commentedon Feb 20, 2026
@R44VC0RP
Thanks for quick response!
I think it’s related to the oc_locale cookie.
If you check Chrome DevTools → Application → Cookies:
When oc_locale=en, the language selector works fine.
When oc_locale is set to something else (e.g. ko), switching to other non-English languages works.
However, switching to English does not work — it just redirects back to the ko docs.
So basically, if oc_locale is not en, I’m unable to view the English docs. It seems like the cookie is forcing a redirect back to the current locale when trying to switch to English.
chenmijiang commentedon Feb 22, 2026
This issue may occur when the browser's "preferred language" is not English.
Seungjun0906 commentedon Feb 22, 2026
Exactly!
trueberryless commentedon Feb 23, 2026
I don't wanna pollute the issue, but I can confirm, this also happens when the preferred language is German in the browser. That way, it is not possible to view the original English documentation, even when switching with the language dropdown or adapting the URL. I think it should be possible to view the docs in a language different from the browser preferred one as translations might be out of date.
Seungjun0906 commentedon Feb 23, 2026
@R44VC0RP
I provided more details! :)
Thanks!
gs-jdudulski commentedon Feb 23, 2026
Same happens to me. I don't have
oc_localecookie, and my firefox has english set as preferred language. I guess it takes a preference from geolocation.olastor commentedon Feb 23, 2026
If anyone needs a quick fix to force the docs to be english, entering
document.cookie = 'oc_locale=en; Path=/; Max-Age=31536000; SameSite=Lax'in the console seems to work around the issue.Seungjun0906 commentedon Feb 23, 2026
It used to set oc_locale depending on preferred language.
R44VC0RP commentedon Feb 23, 2026
Good catch, going to look into this.
gs-jdudulski commentedon Feb 24, 2026
BTW, the polish translation is total slop and I would recommend to remove it, unless you want to keep it as a joke.
mpm commentedon Feb 26, 2026
I want to chime in and express my disappointment about proliferating automatic translations! Don't do that. YouTube and Reddit has pionieered this confusing behavior, it just makes it difficult to use the docs, especially technical documentation.
If anything, consider showing the user an option to switch to their native language (but show the original content as default). Selecting a machine translation right away and making the user search for the language switcher button is just rude.
The translation for technical stuff is very brittle anyway- code and configuration options remain English, so you see a weird mix of languages.
mdread commentedon Feb 27, 2026
Same issue here, trying to switch from Italian to English.
It looks to me that the
https://opencode.ai/docs/endpoint auto-detects the user's language, but specific language endpoints likehttps://opencode.ai/docs/it/orhttps://opencode.ai/docs/es/force the specified language.I think an easy fix that wouldn't require changing much about how the website works would be to add a
/docs/en/endpoint that (like any other language) forces English, then update the language switcher URL to point to that endpoint instead of the root/docs/which would keep acting as it does now with language auto-detection.vimkim commentedon Mar 4, 2026
I want to read documentation in English, not in Korean (since the current translation quality is not too satisfying).
koutiany commentedon Apr 10, 2026
This fixed it, thank you so much! Would really appreciate a fix from opencode if possible.
hongpan-z commentedon May 12, 2026
Besides the console method, another quick fix is to simply replace the language code in the URL to "en". For example,
https://opencode.ai/docs/en/skills/.