> For the complete documentation index, see [llms.txt](https://docs.blockbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockbrain.ai/de/for-admins/web-components/web-component-versioning-overview-and-guide.md).

# Versionierung von Webkomponenten – Überblick & Leitfaden

Die Versionierungsfunktion für die Webkomponente ist jetzt im Produktivsystem live. Im Folgenden finden Sie alle relevanten Details dazu, wie die Versionierung funktioniert und wie Sie verwalten können, welche Version Sie verwenden.

#### 1. Aktuelle Konfiguration (Legacy-URL)

Sie verwenden derzeit die folgende Build-URL:

🔗 <https://assets.theblockbrain.ai/scripts/blocky-chat/blocky-chat.bundle.js>

Dies ist die Legacy-URL und wird immer automatisch die neueste Version bereitstellen. Es ist keine Aktion erforderlich, wenn Sie mit dieser URL bei der neuesten Version bleiben möchten.

***

#### 2. Neue Versionierungs-URLs

Mit der neuen Versionierungsfunktion haben Sie jetzt zwei Möglichkeiten, zu steuern, welche Version der Web-Komponente Sie verwenden:

| Option                    | URL                                                                                    | Beschreibung                                                                                                                                     |
| ------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Immer die neueste Version | <https://assets.theblockbrain.io/scripts/blocky-chat/latest/blocky-chat.bundle.js>     | Zeigt jederzeit automatisch auf die neueste Version.                                                                                             |
| Fixierte Version          | <https://assets.theblockbrain.io/scripts/blocky-chat/v1.0.1-rc5/blocky-chat.bundle.js> | Verweist auf eine bestimmte Version (z. B., `v1.0.1-rc5`). Ersetzen Sie das Versionssegment in der URL, um zu einer anderen Version zu wechseln. |

Alle verfügbaren Versionen und Release-Tags werden hier verwaltet und veröffentlicht:\
🔗 <https://github.com/theblockbrain/b2b-webcomponents/releases>\
\
Sprache

Die Web-Komponente liefert ihre integrierten UI-Texte – Schaltflächenbeschriftungen, den Titel „New Conversation“ und den Eingabeplatzhalter „Write your message“ – in **Englisch (Standard)** und **Deutsch**. Die Sprache wird über den Bundle-Pfad ausgewählt: Fügen Sie das Locale-Segment **nach** dem Versionssegment hinzu.

| Sprache             | Locale-Segment | Beispiel-URL                                                                          |
| ------------------- | -------------- | ------------------------------------------------------------------------------------- |
| Englisch (Standard) | *(keins)*      | `https://assets.theblockbrain.io/scripts/blocky-chat/latest/blocky-chat.bundle.js`    |
| Englisch (explizit) | `/en/`         | `https://assets.theblockbrain.io/scripts/blocky-chat/latest/en/blocky-chat.bundle.js` |
| Deutsch             | `/de/`         | `https://assets.theblockbrain.io/scripts/blocky-chat/latest/de/blocky-chat.bundle.js` |

Das Muster funktioniert mit jeder Version: `.../scripts/blocky-chat/{version}/{locale}/blocky-chat.bundle.js` (z. B. `latest/de/` oder `v1.0.5/de/`).

Um das Widget auf Deutsch umzustellen, ändern Sie nur das Script `src` — lassen Sie alle anderen Attribute (`orgId`, `uid`, `userUid`, `publicToken`) unverändert:

​​

```
<script
  async defer
  src="https://assets.theblockbrain.io/scripts/blocky-chat/latest/de/blocky-chat.bundle.js"
  orgId="..." uid="..." userUid="..." publicToken="...">
</script>
```

> **Hinweis:** Dieser Pfad steuert nur die integrierten statischen Texte der Komponente. Die Willkommensnachricht und die Antworten des Bots folgen den Spracheinstellungen der Plattform und werden von diesem Pfad nicht beeinflusst. Wenn die statischen Beschriftungen auf einer deutschen Seite auf Englisch erscheinen, lädt der Embed das Standard-Bundle (Englisch) — wechseln Sie den `src` zum `/de/` Pfad.

Derzeit sind nur Englisch und Deutsch verfügbar.

***

#### 3. So wechseln Sie Versionen

Der Wechsel zu einer anderen Version ist ganz einfach:

1. Wählen Sie die [gewünschte Version](https://github.com/theblockbrain/b2b-webcomponents/releases)
2. Ersetzen Sie das Versionssegment in der URL (z. B. ändern Sie `v1.0.1-rc5` durch das neue Versions-Tag).
3. Aktualisieren Sie die Skriptreferenz in Ihrer Integration, damit die neue URL verwendet wird.

Das war's — weitere Konfiguration ist nicht erforderlich.

***

#### 4. Woher erfahren Sie von neuen Versionen?

* Wenn Sie die `/latest/` URL verwenden, erhalten Sie immer automatisch die neueste Version.
* Wenn Sie eine fixierte Versions-URL verwenden, benachrichtigen wir Sie, sobald eine neue Version veröffentlicht wird (einschließlich neuer Funktionen und Release-Tags).

***

#### 5. Web-Component-Konfiguration

Sie können Ihre Web-Component-Einstellungen direkt in Ihrem Admin-Tab verwalten. Jeder Mandant hat einen eigenen Web-Components-Tab zur Verwaltung seiner spezifischen Konfiguration:

🔗 <https://into.theblockbrain.ai/manage?tab=webcomponents>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.blockbrain.ai/de/for-admins/web-components/web-component-versioning-overview-and-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
