# Media

De mediabibliotheek onder **Catalogus** → **Media** bevat elke afbeelding van je bedrijf: "Alle afbeeldingen voor dit bedrijf. Uploads worden automatisch geoptimaliseerd." Producten bezitten hun afbeeldingen niet; ze verwijzen naar afbeeldingen uit deze gedeelde bibliotheek. Dat onderscheid is belangrijk bij het verwijderen: een afbeelding van een product halen laat haar in de bibliotheek staan, terwijl verwijderen uit de bibliotheek haar overal weghaalt.

## Afbeeldingen uploaden

1. Klik op de gestreepte tegel **Afbeeldingen uploaden** (of sleep bestanden ergens op het afbeeldingenraster).
2. Kies een of meer bestanden. Alleen JPEG-, PNG-, WebP- en AVIF-afbeeldingen worden geaccepteerd.

Uploads worden op de server automatisch geoptimaliseerd. De alt-tekst wordt voor je ingevuld op basis van elke bestandsnaam: de extensie wordt weggehaald en streepjes en underscores worden spaties (zo wordt `red-garden-chair.jpg` "red garden chair"). Bij het uploaden wordt nooit om alt-tekst gevraagd; die bewerk je achteraf.

Een geslaagde batch toont "{count} afbeeldingen geüpload". Mislukken sommige bestanden in een batch, dan worden de andere toch geüpload en meldt de melding "{ok} geüpload, {failed} mislukt".

## Afbeeldingen vinden

Het zoekveld ("Zoek op bestandsnaam of alt-tekst") filtert het raster terwijl je typt, op bestandsnaam of alt-tekst. Elke tegel toont de afbeelding, de bestandsnaam en de alt-tekst (een gedachtestreepje als die leeg is). Het raster laadt 100 afbeeldingen tegelijk; klik op **Meer laden** voor de volgende pagina. De bibliotheek is een plat raster: er zijn geen mappen, tags of bulkacties.

## De details van een afbeelding bewerken

Beweeg de muis over een tegel en klik op het potloodicoon om het paneel **Afbeeldingsdetails** te openen. Het toont de alleen-lezen velden **Bestandsnaam**, **Type** en **Grootte**, plus een bewerkbaar veld **Alt-tekst**. Wijzig de tekst en klik op **Opslaan** (de knop wordt pas actief zodra de tekst echt anders is); een leeg veld opslaan wist de alt-tekst. De melding "Alt-tekst opgeslagen" bevestigt het.

Alt-tekst staat op het mediarecord zelf, dus een wijziging geldt overal waar de afbeelding wordt gebruikt, inclusief elk product waaraan ze is gekoppeld.

## Een afbeelding verwijderen

Beweeg de muis over een tegel en klik op het prullenbakicoon. De bevestiging waarschuwt: "Afbeelding verwijderen?" / "De afbeelding wordt verwijderd uit de opslag en van alle producten die deze gebruiken." Dit is de definitieve variant: na bevestiging wordt het bestand uit de opslag verwijderd en in één keer van elk product losgekoppeld.

## Productafbeeldingen

De detailpagina van elk product heeft een kaart **Afbeeldingen** voor de afbeeldingen die aan dat product zijn gekoppeld. De hint vat het model samen: "Sleep om te herschikken. De eerste grote afbeelding is de uitgelichte afbeelding."

### Afbeeldingen aan een product koppelen

- **Afbeeldingen toevoegen**: de gestreepte tegel opent een bestandskiezer (dezelfde formaten: JPEG, PNG, WebP, AVIF; meerdere bestanden), of sleep bestanden op de kaart. Elk bestand wordt naar de gedeelde mediabibliotheek geüpload en daarna aan het product gekoppeld.
- **Kies uit bibliotheek**: opent een dialoogvenster met een doorzoekbaar raster ("Zoek media", paginering via **Meer laden**) van bibliotheekafbeeldingen die nog niet op het product staan. Klik op een afbeelding om haar te koppelen; het dialoogvenster sluit met de melding "1 afbeelding toegevoegd".

### Uitgelichte afbeelding en volgorde

De uitgelichte (primaire) afbeelding wordt als eerste getoond als de grote 2x2-tegel en draagt een badge **Primair**. Om haar te wijzigen beweeg je de muis over een andere afbeelding en klik je op de ster (**Als uitgelicht instellen**); "Uitgelichte afbeelding bijgewerkt" bevestigt het.

Sleep de andere miniaturen om ze te herschikken (herschikken met het toetsenbord werkt ook); "Volgorde opgeslagen" bevestigt elke wijziging. De uitgelichte afbeelding zelf kan niet worden versleept.

### Acties per afbeelding

Als je de muis over een productafbeelding beweegt, verschijnen:

- **Als uitgelicht instellen** (ster): maak dit de primaire afbeelding.
- **Alt-tekst bewerken** (potlood): een venster met een invoerveld **Alt-tekst** dat opslaat wanneer je het veld verlaat. Dit bewerkt het gedeelde mediarecord, dus de nieuwe alt-tekst geldt overal waar de afbeelding wordt gebruikt, niet alleen op dit product.
- **Afbeelding verwijderen** (X): koppelt de afbeelding los na de bevestiging "Afbeelding verwijderen?" / "Dit verwijdert de afbeelding van het product. Deze blijft in je mediabibliotheek."

Klik op een miniatuur om een lightbox te openen met de knoppen **Vorige**/**Volgende**, navigatie met de pijltjestoetsen en een teller "n/totaal".

### Keuze-afbeeldingen in de configurator

Bij producten op maat heeft elke optiekeuze een dialoogvenster **Afbeeldingen** (geopend vanuit de [kaart Optiegroepen](/nl/docs/products/variants-and-configurator)) dat afbeeldingen uit dezelfde bibliotheek kiest. Klik op afbeeldingen om ze te selecteren of te deselecteren; geselecteerde afbeeldingen krijgen een genummerde badge, en die selectievolgorde is de volgorde waarin ze worden opgeslagen en getoond. Klik op **Afbeeldingen opslaan** om de selectie te bewaren ("Afbeeldingen opgeslagen.").

Webshops ontvangen deze afbeeldingen via de product-API; zie de [API-referentie voor producten](/nl/api/catalog/products).