Shopify variantafbeeldingen niet zichtbaar: 10 oorzaken
Je hebt elke variant afbeeldingen toegewezen. Je opent de productpagina, selecteert een andere kleur en de galerij verandert niet. Alle 40 foto’s staan er nog. De filtering werkt niet.
Frustrerend, maar bijna altijd op te lossen. In de meeste gevallen gaat het om een instelling die ontbreekt, of een klein detail dat over het hoofd is gezien. Dit artikel beschrijft de 10 meest voorkomende oorzaken en toont voor elke de oplossing.
In dit artikel
- 1. App-inbedding niet geactiveerd
- 2. Afbeeldingen niet toegewezen
- 3. Verkeerd thema actief
- 4. Product niet opnieuw opgeslagen
- 5. Dubbele bestandsnamen
- 6. Browsercache
- 7. Conflict met andere app
- 8. Page builder in gebruik
- 9. Product in concept
- 10. Thema-update heeft instellingen overschreven
- Snelle checklist
- Video
- Veelgestelde vragen
- Verder lezen
1. App-inbedding niet geactiveerd
Dit is de meest voorkomende oorzaak. De app is geinstalleerd, maar de app-embed in de thema-editor staat uit. Zonder geactiveerde inbedding laadt de app geen JavaScript op de storefront. De galerij kan zich niet filteren, omdat de code er simpelweg niet is.
Oplossing: Ga naar Thema-editor > App-inbeddingen (links onderaan in de zijbalk). Zoek “Rubik Variant Images” en zet de schakelaar aan. Sla het thema op.
Belangrijk: de app-embed moet per thema geactiveerd worden. Wissel je van thema, dan moet je de inbedding in het nieuwe thema opnieuw aanzetten.
2. Afbeeldingen niet toegewezen
Shopify staat standaard een afbeelding per variant toe. Dat je in de Shopify-admin een afbeelding aan een variant hebt gekoppeld, is niet voldoende voor de galerijfiltering. De app heeft een eigen beeldtoewijzing nodig, omdat Shopify geen meervoudige toewijzing ondersteunt.
Oplossing: Open het product in de Rubik-app (niet in de Shopify-admin). Selecteer een variant. Sleep de gewenste afbeeldingen naar het toewijzingsgebied. Sla op. Herhaal dit voor elke variant. Of gebruik de AI Auto-Assign, die afbeeldingen automatisch aan de juiste varianten koppelt.
3. Verkeerd thema actief
Je hebt de app in de thema-editor van een bepaald thema geactiveerd. Maar het live thema is een ander. Shopify staat onbeperkt veel geinstalleerde thema’s toe. De app-embed is themaspecifiek.
Oplossing: Controleer onder Online Store > Thema’s welk thema als “Live” is gemarkeerd. Open de thema-editor van dat thema en activeer daar de app-embed. Niet in het concept-thema, maar in het actieve.
4. Product niet opnieuw opgeslagen
Rubik slaat variantafbeeldingsdata op in Shopify-metavelden. Als je varianten toevoegt of afbeeldingen wijzigt in Shopify nadat je in de app hebt toegewezen, kan er een mismatch ontstaan. De app-data verwijzen naar afbeeldingen of varianten die inmiddels andere namen of ID’s hebben.
Oplossing: Open het product opnieuw in de Rubik-app. Controleer of alle toewijzingen nog kloppen. Sla opnieuw op. De metavelden worden bijgewerkt.
5. Dubbele bestandsnamen
Upload je dezelfde afbeelding twee keer, dan voegt Shopify een nummer toe aan de bestandsnaam (afbeelding.jpg, afbeelding_1.jpg). In de app zien beide foto’s er hetzelfde uit, maar ze hebben verschillende bestandsnamen. De toewijzing kan in de war raken als Shopify intern de versie met het nummer gebruikt, maar de app naar het origineel verwijst.
Oplossing: Verwijder dubbele afbeeldingen in de Shopify-productgalerij. Bewaar per opname slechts een versie. Wijs daarna opnieuw toe in de Rubik-app en sla op.
6. Browsercache
Je hebt alles goed ingesteld, maar de pagina toont nog de oude versie. De browser heeft de pagina gecacht, inclusief het oude JavaScript en de oude metavelddata.
Oplossing: Leeg de browsercache of open de productpagina in een incognitovenster. Op Mac: Cmd+Shift+R voor een cachevrije herlaadbeurt. Op Windows: Ctrl+Shift+R. Gebruik je Shopify Storefront-caching of een CDN-extensie, leeg dan ook daar de cache.
7. Conflict met andere app
Sommige apps grijpen in op de productpagina: andere swatch-apps, beeldoptimalisatietools, lazy-loading-scripts of thema-extensies die de galerij aanpassen. Als twee apps dezelfde afbeeldingsgalerij proberen te sturen, ontstaan er conflicten.
Oplossing: Deactiveer tijdelijk alle andere apps die met de productpagina interacteren. Test de galerijfiltering. Werkt het? Activeer de andere apps een voor een weer, totdat je het conflict vindt. Neem dan contact op met de Rubik-support, die kan helpen bij het oplossen.
8. Page builder in gebruik
GemPages, PageFly, EComposer, Instant, Beae, Foxify en Replo maken hun eigen productpaginalayouts. Het standaard thema-template wordt daarbij omzeild. De app moet weten dat er een page builder actief is, zodat de juiste selectors voor de galerij worden gebruikt.
Oplossing: Rubik Variant Images ondersteunt alle 7 genoemde page builders met eigen code. Controleer of je de meest recente app-versie gebruikt. Blijft het probleem bestaan? Neem contact op met de support en meld welke page builder je gebruikt.
9. Product in concept
Producten met de status “Concept” zijn niet zichtbaar op de storefront. Open je de productpagina via de Shopify-preview, dan kan de app alsnog werken. Maar de publieke URL toont een 404-pagina.
Oplossing: Zorg ervoor dat de productstatus op “Actief” staat. Controleer ook het verkoopkanaal: het product moet aan de Online Store zijn toegewezen, niet alleen aan POS of een ander kanaal.
10. Thema-update heeft instellingen overschreven
Bij sommige thema-updates wordt de app-embed gereset. Dat gebeurt zelden, maar het komt voor. Vooral bij een overstap van een oudere themaversie naar een volledig nieuwe versie.
Oplossing: Ga na elke thema-update naar de thema-editor en controleer of de app-embed voor Rubik Variant Images nog actief is. Zo niet: aanzetten, opslaan, klaar.
Snelle checklist
Loop deze punten door voordat je de support contacteert:
- App-embed in het live thema geactiveerd?
- Afbeeldingen in de Rubik-app (niet alleen in Shopify-admin) toegewezen?
- Incognitovenster getest?
- Product actief en aan Online Store toegewezen?
- Geen andere swatch- of galerij-app actief?
Meer achtergrond over waarom Shopify standaard alle afbeeldingen tegelijk toont en hoe Rubik dat verandert, vind je in ons artikel Alleen geselecteerde variantafbeeldingen tonen.
Video
Stap voor stap: zo stel je de galerijfiltering in en vermijd je de meest voorkomende fouten:
Veelgestelde vragen
Waarom toont Shopify alle afbeeldingen tegelijk?
Shopify behandelt afbeeldingen als platte lijst op productniveau. Per variant kan slechts een hoofdafbeelding worden gekoppeld. De galerij filtert niet op variant, maar toont altijd alles. Dat is geen bug, maar een ontwerpkeuze van het platform. Voor filtering heb je een app nodig.
Mijn afbeeldingen zijn toegewezen maar de galerij filtert niet. Wat nu?
Controleer eerst of de app-embed in de thema-editor is geactiveerd. Test daarna in een incognitovenster (browsercache). Zorg ervoor dat de afbeeldingen in de Rubik-app zijn toegewezen, niet alleen in de Shopify-admin. De 10 oorzaken in dit artikel dekken vrijwel alle scenario’s.
Werkt de galerijfiltering met mijn thema?
Rubik Variant Images ondersteunt meer dan 350 thema’s met native code, waaronder alle gratis Shopify-thema’s (Dawn, Horizon, Sense, Craft), populaire premium thema’s (Impulse, Impact, Prestige, Focal) en 7 page builders. De volledige lijst vind je in de documentatie.
Kan een andere app de galerijfiltering verstoren?
Ja. Andere swatch-apps, beeldoptimalisatietools of lazy-loading-scripts kunnen conflicten veroorzaken. Deactiveer andere apps tijdelijk en neem contact op met de Rubik-support als er een conflict is.
Wat gebeurt er na een thema-update?
In zeldzame gevallen wordt de app-embed bij een thema-update gereset. Controleer na de update in de thema-editor of Rubik Variant Images nog geactiveerd is. Je beeldtoewijzingen in de app blijven altijd behouden. Die zijn opgeslagen in metavelden en onafhankelijk van het thema.
Verder lezen
