# Troubleshooting

> Quick fixes for common, isolated issues in deco.cx storefronts. Use when the user reports a specific symptom that doesn't warrant a full skill. This is a growing knowledge base — add new entries as they're discovered.

- Skill: `decocms/troubleshooting` (Agent Skill)
- Install (CLI): `npx skillmds@latest add decocms/troubleshooting`
- Raw SKILL.md: https://api.skillmd.com/api/skills/decocms/troubleshooting/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: decocms (https://skillmd.com/u/decocms)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/decocms/troubleshooting

---


A living collection of quick fixes for one-off problems in deco.cx storefronts. Each entry describes the symptom, root cause, and exact fix.

---

## Entries

### HTML `lang` attribute wrong or missing

**Symptom:** The page renders with `<html lang="en">` (or no `lang`) but the site is in Portuguese (or another language). Accessibility tools and SEO audits flag the mismatch.

**Root cause:** In Deno Fresh, the `lang` attribute on `<html>` is set via `ctx.lang` inside the `render` callback of `fresh.config.ts`. If the line is absent, Fresh defaults to `"en"`.

**Fix:** Open `fresh.config.ts` at the project root and add (or update) the `render` callback:

```ts
import { defineConfig } from "$fresh/server.ts";
import { plugins } from "deco/plugins/deco.ts";
import manifest from "./manifest.gen.ts";

export default defineConfig({
  plugins: plugins({
    manifest,
    htmx: true, // keep whatever options were already here
  }),
  render: (ctx, render) => {
    ctx.lang = "pt-BR"; // ← set to the correct BCP-47 language tag
    render();
  },
});
```

Common language tags: `pt-BR`, `pt-PT`, `en`, `en-US`, `es`, `es-AR`.

**Verify:** After deploying, inspect the page source and confirm `<html lang="pt-BR">`.

---

<!-- Add new entries below this line, following the same format:
### Short symptom title
**Symptom:**
**Root cause:**
**Fix:**
**Verify:**
-->

