> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Terminbuchungskalender wird in meinem Shop nicht angezeigt [Behoben]

> ℹ️ **Note:** Dieser Artikel wurde automatisch mit AI übersetzt und kann Ungenauigkeiten enthalten. Wenn etwas falsch aussieht, kontaktieren Sie bitte unser Support-Team.

Der Buchungskalender funktioniert normalerweise direkt nach der Einrichtung – manchmal kann jedoch eine kleine Konfiguration, ein Theme oder eine Verfügbarkeitseinstellung verhindern, dass er in deinem Shop angezeigt wird.

Die gute Nachricht: Diese Probleme lassen sich meist sehr schnell beheben 🚀

Diese Anleitung zeigt die häufigsten Gründe, warum der Buchungskalender (oder seine Schaltfläche **Book Now** (Jetzt buchen)) möglicherweise nicht angezeigt wird, und wie du jeden Schritt für Schritt behebst.

In den meisten Fällen hängt das Problem mit einer der folgenden Ursachen zusammen:

* App Embed ist deaktiviert
* Service wurde nicht gespeichert, wurde deaktiviert oder archiviert
* Du prüfst die falsche Produktseite oder Variante
* Produktvarianten wurden nach Erstellung des Service geändert
* Du siehst dir einen Entwurf (unveröffentlichtes Theme) an
* Konflikte mit individuellem Theme oder Page Builder
* Verfügbarkeitseinstellungen blenden alle Termine aus
* Zeitfenster sind vollständig gebucht oder Buchungslimits sind erreicht
* Browser- oder Shop-Cache

Gehen wir sie einzeln durch 👇

---

# **✅ Schritt 1: Prüfe, ob App Embed aktiviert ist**

Damit der Buchungskalender in deinem Shop angezeigt wird, muss das App Embed in deinem Shopify-Theme aktiviert sein. Das ist die häufigste Ursache.

Der schnellste Weg, das zu prüfen, ist direkt in der App:

Öffne die App **Hoppy Appointments** → auf der Seite **dashboard/homepage** (Dashboard/Startseite) findest du die Karte **App Status** (App-Status).

* **Active** (Aktiv) → Das App Embed ist aktiviert ✅
* **Inactive** (Inaktiv) → Klicke auf **Activate** (Aktivieren) – du wirst direkt zum Theme-Editor weitergeleitet

Um es stattdessen manuell zu aktivieren, gehe zu:

**Shopify Admin → Online Store → Themes → Customize → App Embeds**

Dann:

* Suche „**Appointment Bookings**“
* Schalte es auf **ON** (Ein)
* Klicke auf **Save** (Speichern)

Tipp:  
Wenn es bereits aktiviert war, schalte es auf **OFF** (Aus), klicke auf **Save** (Speichern), dann auf **ON** (Ein) und erneut auf **Save** (Speichern). Aktualisiere anschließend deinen Shop.

Nach diesem Schritt sollte die Schaltfläche **Book Now** auf der mit deinem Service verknüpften Produktseite erscheinen.

---

# **✅ Schritt 2: Stelle sicher, dass der Service gespeichert und aktiv ist**

Auch wenn das App Embed aktiviert ist, erscheint ein Service nur in deinem Shop, wenn er **gespeichert** und **aktiv** ist.

Öffne die App → **dashboard/homepage** (Dashboard/Startseite) und prüfe das Badge neben deinem Service:

* **Inactive** (Inaktiv) → Öffne das Menü **More** (Mehr) → **Turn on** (Einschalten)
* **Archived** (Archiviert) → Öffne das Menü **More** (Mehr) → **Unarchive** (Wiederherstellen), und stelle sicher, dass es eingeschaltet ist

Öffne als Nächstes den Service und klicke auf **Save** (Speichern) – auch wenn du nichts geändert hast.

Durch das Speichern wird der Service mit deinem Shop neu synchronisiert, was die meisten Fälle von „es hat vorher funktioniert“ behebt.

Nach dem Speichern erscheint ein Banner oben auf der Seite:

* **„Make sure Appointment Booking App Embed is active“** → Klicke auf **Enable App Embed** (App Embed aktivieren) (siehe Schritt 1)
* **„Confirm Appointment Booking is published successfully“** → Klicke auf **Open Store** (Shop öffnen), um das Ergebnis zu prüfen

ℹ️ Wenn die Schaltfläche **Book Now** ein leeres Pop-up öffnet, ist der Service in der Regel ausgeschaltet oder archiviert – dieser Schritt behebt auch das.

---

# **✅ Schritt 3: Prüfe, ob du auf der richtigen Produktseite und Variante bist**

Die Schaltfläche **Book Now** erscheint nur auf der Produktseite, die mit deinem Service verbunden ist – nicht auf anderen Produkten.

Öffne deinen Service → Registerkarte **General** (Allgemein) → Karte **Booking** (Buchung) und bestätige, welches Produkt ausgewählt ist.

Beispiel:  
Wenn dein Service mit „Guitar Lesson“ verbunden ist, du aber die Produktseite „Drum Lesson“ aufrufst, erscheint die Schaltfläche dort nicht.

Wenn das Produkt **mehrere Varianten** hat, versuche auch, auf der Shop-Seite zwischen den Varianten zu wechseln.

⚠️ Wichtig:

Wenn du die Varianten des Produkts in Shopify **nach** der Einrichtung des Service bearbeitet, gelöscht oder neu erstellt hast, kann die Verbindung veraltet sein.

Die Lösung ist einfach:

→ Öffne den Service  
→ Klicke auf **Change** (Ändern)  
→ Wähle nach der Änderung der Produktvarianten die richtigen Varianten aus  
→ Klicke auf **Save** (Speichern) 

Damit werden die aktuellen Produkt- und Varianteninformationen mit deinem Shop neu synchronisiert.

---

# **✅ Schritt 4: Prüfe dein live veröffentlichtes Theme**

Das App Embed wird geprüft – und der Kalender angezeigt – nur in deinem **live veröffentlichten Theme**.

Das bedeutet:

* Wenn du das App Embed aktivierst, während du einen **Entwurf oder unveröffentlichtes Theme** bearbeitest, erscheint der Kalender nicht in deinem Live-Shop
* Wenn du kürzlich **zu einem neuen Theme gewechselt** bist, bleibt das App Embed im neuen Theme deaktiviert, bis du es erneut aktivierst (siehe Schritt 1)

Teste immer in deinem Live-Shop:

→ Öffne deinen Shop in einem normalen Browser-Tab, nicht nur in der Theme-Editor-Vorschau.

---

# **✅ Schritt 5: Hartes Neuladen und Inkognito-Modus testen**

Manchmal speichert Shopify oder dein Browser Shop-Inhalte temporär im Cache.

Ein hartes Neuladen behebt das meist sofort.

### **Windows**

`Ctrl + Shift + R`

### **Mac**

`Cmd + Shift + R`

Versuche außerdem:

* Deinen Shop in einem **Inkognito-/Privatfenster** zu öffnen
* In einem anderen Browser oder auf deinem Smartphone zu testen

Damit stellst du fest, ob es sich nur um zwischengespeicherte Inhalte handelt.

---

# **✅ Schritt 6: Verwendest du ein individuelles Theme oder einen Page Builder?**

Die meisten Shopify-Themes funktionieren sofort mit Hoppy Appointments – die App ersetzt automatisch die Schaltfläche **Add to Cart** (In den Warenkorb) durch die Schaltfläche **Book Now** (Jetzt buchen) auf buchbaren Produktseiten.

Stark angepasste Themes oder Themes, die mit Page Buildern erstellt wurden, verwenden jedoch möglicherweise nicht-standardisierte Produktformulare, die die App nicht immer erkennen kann.

In diesem Fall platziere den Kalender manuell:

Öffne den **Shopify Theme Editor** (Theme-Editor) → **Navigate to the desired page** (Zur gewünschten Seite navigieren) → **Add Block** (Block hinzufügen) → **Apps** → **Appointment Calendar** (Terminkalender)

Dann:

* Füge deine **Service ID** (Service-ID) ein  
  → Du findest sie oben auf der Service-Bearbeitungsseite oder über **My services** (Meine Services) → **More** (Mehr) → **Copy Service ID** (Service-ID kopieren)
* Wähle den **Embedding Mode** (Einbettungsmodus):  
  * **Modal** → Zeigt eine Buchungskarte, die den Kalender in einem Pop-up öffnet  
  * **Direct** (Direkt) → Betten den vollständigen Kalender direkt auf der Seite ein
* Klicke auf **Save** (Speichern), um das Theme zu speichern

Der Block zeigt dir auch an, wenn etwas nicht stimmt:

* **„App Embed Not Enabled“** (App Embed nicht aktiviert) → Gehe zurück zu Schritt 1 – das App Embed ist auch für die manuelle Platzierung erforderlich
* **„Appointment service configuration not found“** (Terminservice-Konfiguration nicht gefunden) → Prüfe die eingefügte Service ID noch einmal

💡 Alternative: Aktiviere den **Floating Action Button** (Schwebende Aktions-Schaltfläche) in deinem Service (**General**-Registerkarte (Allgemein) → **Enable floating button** (Schwebende Schaltfläche aktivieren)), um eine schwebende Schaltfläche **Book Now** auf allen Shop-Seiten anzuzeigen. Vergiss nicht, den Service anschließend über **Save** (Speichern) zu speichern.

---

# **✅ Schritt 7: Kalender öffnet sich, aber es gibt keine Termine/Uhrzeiten? Prüfe die Verfügbarkeit**

Wenn sich das Pop-up öffnet, Kunden aber keine Termine auswählen können, liegt das meist an den Verfügbarkeitseinstellungen.

Öffne deinen Service → Registerkarte **Availability** (Verfügbarkeit) und prüfe Folgendes:

* **Working days** (Arbeitstage) sind auf **ON** (Ein) geschaltet und haben gültige Start- und Endzeiten
* **Date-range availability** (Datumsbereich-Verfügbarkeit) → Wenn du bestimmte Daten festgelegt hast, die nun in der Vergangenheit liegen, werden nie Termine angezeigt. Füge einen neuen, aktuellen Datumsbereich hinzu
* **Minimum scheduling notice** (Minimale Vorlaufzeit) → Ein hoher Wert (z. B. 48 Stunden) entfernt heute und morgen aus dem Kalender. Der Standardwert ist 1 Stunde
* **Look ahead** (Vorausschau) → Legt fest, wie weit im Voraus Kunden buchen können. Ein niedriger Wert (z. B. 2–3 Tage) lässt den Kalender fast leer erscheinen
* **Break times** (Pausenzeiten) → Stelle sicher, dass sie nicht deine gesamten Arbeitszeiten abdecken
* **Blocked dates** (Blockierte Termine) → Entferne alle Termine, die nicht blockiert sein sollten

Beispiel:  
Wenn dein **Look ahead** (Vorausschau) auf 2 Tage und deine **Minimum scheduling notice** (Minimale Vorlaufzeit) auf 48 Stunden eingestellt ist, sehen Kunden möglicherweise überhaupt keine buchbaren Termine.

Nach der Anpassung klicke auf **Save** (Speichern) und aktualisiere deinen Shop – die Termine sollten nun auswählbar sein.

---

# **✅ Schritt 8: Zeitzoneneinstellungen prüfen**

Eine falsche Zeitzone kann deine Zeitfenster verschieben – oder so aussehen lassen, als wären zu den gewünschten Zeiten keine Termine verfügbar.

Öffne deinen Service → Registerkarte **Availability** (Verfügbarkeit) → Karte **Timezone & hour format** (Zeitzone & Stundenformat):

* Bestätige, dass deine **Timezone** (Zeitzone) korrekt ist
* **Lock timezone** (Zeitzone sperren) → Wenn aktiviert, sehen alle Kunden Zeiten in deiner Zeitzone, unabhängig von ihrem Standort
* **Show timezone selector** (Zeitzonenauswahl anzeigen) → Ermöglicht Kunden, in ihre eigene Zeitzone zu wechseln

💡 Wenn Kunden in anderen Ländern von „fehlenden“ Zeiten berichten, sehen sie deinen Zeitplan wahrscheinlich in ihre lokale Zeitzone umgerechnet.

---

# **✅ Schritt 9: Prüfe, ob Zeitfenster ausgebucht oder Limits erreicht sind**

Manchmal funktioniert der Kalender einwandfrei – die Zeitfenster sind einfach bereits vergeben.

Prüfe Folgendes:

* **Maximum bookings per time slot** (Maximale Buchungen pro Zeitfenster) → Der Standardwert ist 1, sodass ein Zeitfenster verschwindet, sobald jemand gebucht hat. Erhöhe ihn für Gruppenkurse oder -sessions
* **Maximum bookings per day** (Maximale Buchungen pro Tag) → Sobald dieser Wert erreicht ist, wird der gesamte Tag nicht mehr verfügbar
* **Existing bookings** (Bestehende Buchungen) → Öffne die Seite **Bookings** (Buchungen), um zu sehen, welche Zeitfenster bereits vergeben sind

Verwendest du den Modus **Availability per teammate** (Verfügbarkeit pro Teammitglied)?

Wenn dem Service keine Teammitglieder zugewiesen sind, werden überhaupt keine Zeitfenster generiert:

→ **Availability**-Registerkarte (Verfügbarkeit) → **Assign teammates to this service** (Teammitglieder diesem Service zuweisen), oder wechsle zurück zu **Availability per service** (Verfügbarkeit pro Service)

💡 Sollen ausgebuchte Tage weiterhin sichtbar bleiben?

Aktiviere die **Waitlist** (Warteliste) in der Registerkarte **Payment** (Zahlung), und schalte **Show waitlist when a slot is fully booked** (Warteliste anzeigen, wenn ein Zeitfenster ausgebucht ist) ein – Kunden sehen dann eine Option **Join waitlist** (Warteliste beitreten) anstelle eines leeren Kalenders.

---

# **⚠️ Gut zu wissen**

* Die Vorschau auf der Service-Setup-Seite ist ungefähr – vertraue immer dem Kalender auf deiner **live Produktseite**.
* Der App-Block **Appointment Calendar** (Terminkalender) erfordert ebenfalls das App Embed aus Schritt 1.
* Jedes Produkt oder jede Variante kann jeweils nur mit **einem aktiven Service** verbunden sein.

---

# **Wird immer noch nicht angezeigt?**

Wenn du alle oben genannten Schritte ausprobiert hast und der Buchungskalender immer noch nicht sichtbar ist:

1. Speichere den Service erneut
2. Bestätige, dass **App Status** (App-Status) **Active** (Aktiv) anzeigt
3. Teste auf der live Produktseite (nicht in der Theme-Vorschau)
4. Teste in einem Inkognito-Fenster

Wenn das Problem weiterhin besteht, kontaktiere uns gerne direkt aus der Hoppy Appointments App.

Um uns die Fehlerbehebung zu erleichtern, füge bitte Folgendes bei:

* Deine Shop-URL
* Die Produktseiten-URL, auf der der Kalender erscheinen sollte
* Deine **Service ID** (**My services** (Meine Services) → **More** (Mehr) → **Copy Service ID** (Service-ID kopieren))
* Dein Theme-Name
* Ein Screenshot der Karte **App Status** (App-Status)

Wir helfen dir gerne weiter 🙌

---