> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/sv/brand-pages/brand-page-retailer-integration-guide/module-capabilities.md).
# Modulfunktioner
Detta dokument beskriver varje tillgänglig modultyp, dess fält, begränsningar och konfigurationsalternativ. Använd det som återförsäljarvänd referens för vad varje modul stöder och vad varumärken kan konfigurera när de skapar innehåll för varumärkessidan.
***
## Modultyper i översikt
| Modul | Syfte |
| ------------ | --------------------------------------------------------------------------- |
| Hero Banner | Media i fullbredd med rubrik, undermeny och CTA |
| Bild | Enskild bild med valfri bildtext, alt-text och länk |
| Text | Rubrik, tagline, brödtext eller anpassad flerraders text |
| Delad layout | Tvåkolumns- eller staplad layout som innehåller bild- och/eller textmoduler |
| Bildgalleri | Rutnät av bilder med valfri sektionstitel, beskrivning och CTA |
| Filtermeny | Navigeringsfält med märkta filterobjekt |
| Produktnät | Kuraterat produktnät med valfri filtrering och CTA |
## Gemensamma fält (alla moduler)
Varje modul delar följande systemhanterade fält. Varumärken ställer inte in dessa direkt.
| Fält | Beskrivning |
| --------------------------- | --------------------------------------------------------------------------- |
| `id` | Automatiskt genererad unik identifierare |
| `brandPageModuleTemplateId` | Länkar innehåll till återförsäljarens modulmall |
| `order` | Visningsposition på sidan (hanteras via dra-och-släpp) |
| `optionality` | Om hela modulen krävs eller kan hoppas över (definieras av återförsäljaren) |
## 1. Hero Banner
En banner i fullbredd som kombinerar en bakgrundsbild, överlägg, rubriktext och en uppmaning (CTA). Detta är vanligtvis den första modulen på varumärkessidan.
### Media
| Fält | Krävs? | Begränsningar |
| -------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Bild | Krävs | Format: `GIF`, `JPG`, `PNG`, `SVG` · Minst dimensioner: definieras av återförsäljaren · Max filstorlek: definieras av återförsäljaren |
| Alt-text | Krävs eller valfritt (definieras av återförsäljaren) | Beskrivande text för tillgänglighet |
{% hint style="info" %}
Videostöd är planerat men ännu inte tillgängligt. Endast bild accepteras för närvarande.
{% endhint %}
### Överlägg
Återförsäljaren definierar om ett överlägg är tillgängligt för denna modul:
| Inställning | Beteende |
| --------------------- | ------------------------------------------------------------- |
| `disabled` | Inget överlägg — bilden visas utan något färglager |
| `optional` (tillåtet) | Varumärket kan välja att aktivera eller inaktivera överlägget |
| `required` | Överlägg visas alltid; varumärket kan inte stänga av det |
När överlägget är aktiverat väljer varumärket bakgrundsstil. Återförsäljaren styr vilka stilar som erbjuds:
| Stil | Beskrivning |
| ---------- | ------------------------------- |
| `gradient` | Gradvis uteslutning från bilden |
| `solid` | Enfärgat färgblock bakom texten |
Båda alternativen kan göras tillgängliga samtidigt.
### Textinnehåll
| Fält | Krävs? | Begränsningar |
| ------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Rubrik | Krävs | Max antal tecken: definieras av återförsäljaren |
| Underrubrik | Valfritt | Max antal tecken: definieras av återförsäljaren |
| CTA-knapptext | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | Max antal tecken: definieras av återförsäljaren |
| CTA-länk-URL | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | Max antal tecken: definieras av återförsäljaren · Måste vara en giltig URL |
{% hint style="info" %}
CTA-texten och CTA-länken konfigureras tillsammans. Om CTA är inaktiverat visas inget av fälten. Du kan inte ha en CTA-länk utan en CTA-knapp, eller vice versa.
{% endhint %}
### Textjustering
Återförsäljaren definierar vilka justeringsalternativ som är tillgängliga. Möjliga värden: `left`, `center`, `right`. Varumärket väljer från den erbjudna uppsättningen.
## 2. Bild
En enskild bild med valfri bildtext, alt-text och en länkdestination.
### Bilduppladdning
| Fält | Krävs? | Begränsningar |
| -------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Bild | Krävs | Format: `GIF`, `JPG`, `PNG`, `SVG` · Minst dimensioner: definieras av återförsäljaren · Max filstorlek: definieras av återförsäljaren |
| Alt-text | Krävs eller valfritt (definieras av återförsäljaren) | Beskrivande text för tillgänglighet |
### Bildtext
| Fält | Krävs? | Begränsningar |
| -------- | -------- | ---------------------------------------------------- |
| Bildtext | Valfritt | Max antal tecken: återförsäljardefinierat · Enkelrad |
{% hint style="info" %}
Tillgänglighet för bildtext är återförsäljardefinierad. Om återförsäljaren inte har aktiverat bildtexter visas inte fältet.
{% endhint %}
### Länk
Varje bild kan valfritt länka till en destination. Varumärket väljer en av tre länktyper:
| Länktyp | Beskrivning |
| --------- | ----------------------------------------------------------------------- |
| `image` | Ingen länk – bilden är icke-interaktiv |
| `url` | Navigerar till en anpassad URL när den väljs |
| `product` | Navigerar till en specifik produktdetaljsida (vald via produktväljaren) |
### Ytterligare textrader
Vissa bildmoduler stöder extra etiketterade textrader bredvid bilden (till exempel en titel eller beskrivning som återges under eller över bilden). Tillgänglighet, etiketter, teckenstorlekar och om varje rad är obligatorisk eller valfri är alla återförsäljardefinierade.
## 3. Text
En flexibel textmodul som stöder enkelrads- och flerradsvarianter.
### Varianter
Återförsäljaren definierar vilken variant modulen använder:
| Variant | Beskrivning |
| ---------- | ------------------------------------------------------------------------------ |
| `headline` | En enskild framträdande textrad – stor, fet |
| `tagline` | En enskild stödjande rad – mindre än rubriken |
| `body` | Ett enskilt block med brödtext – återges som ett textområde |
| `lines` | Flera namngivna textrader, var och en med sin egen teckenstorlek och valfrihet |
### Fält – enkelradsvarianter (`headline`, `tagline`, `body`)
| Fält | Krävs? | Begränsningar |
| ---- | ------ | -------------------------------------------------------------- |
| Text | Krävs | Max antal tecken: återförsäljardefinierat (gäller hela fältet) |
### Fält – flerradsvariant (`lines`)
Varje rad definieras oberoende av återförsäljaren:
| Fält | Krävs? | Begränsningar |
| ------- | ------------------------------------------------------------ | ---------------------------------------------------------- |
| Radtext | Obligatorisk eller valfri (per rad, återförsäljardefinierat) | Max antal tecken: återförsäljardefinierat (gäller per rad) |
| Rad-URL | Valfritt | Endast tillgänglig på rader där `isHyperlink` är aktiverat |
### CTA
| Fält | Krävs? | Begränsningar |
| ------------- | ----------------------------------------------------------------- | ------------------------ |
| CTA-knapptext | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | — |
| CTA-länk-URL | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | Måste vara en giltig URL |
{% hint style="info" %}
CTA-valfrihet gäller för både texten och URL:en tillsammans. Om den inaktiveras visas inget av fälten.
{% endhint %}
### Justering
Återförsäljardefinierat. Möjliga värden: `left`, `center`, `right`. Gäller all text i modulen.
### Maxbredd
Återförsäljaren anger en `maxWidth` -begränsning som begränsar hur brett textblocket kan återges (till exempel `600px` or `80%`). Detta är en visningsbegränsning, inte en innehållsbegränsning.
## 4. Delad layout
En layoutbehållare som innehåller två eller flera underordnade moduler ordnade i kolumner eller rader. De underordnade modulerna är **Image**- och/eller **Text**-moduler. Nästling stöds upp till djup 2, men du kan inte nästla delade layouter på rotnivå.
### Layoutalternativ
| Layout | Alternativ |
| --------- | ---------------------------------------------------------------------------------------------------- |
| `columns` | Sida vid sida. Förhållande: `50:50`, `33:67`, or `67:33` (återförsäljardefinierat vilka som erbjuds) |
| `rows` | Staplade vertikalt |
### Avstånd
Avståndet mellan underordnade element är återförsäljardefinierat, hämtat från återförsäljarens stilguide för avståndsskala.
### Underordnade element
| Egenskap | Värde |
| --------------------------- | ---------------------------------------------------------------------------------------- |
| Tillåtna underordnade typer | `Image`, `Text` |
| Antal underordnade element | Återförsäljardefinierat (`numChildren`) |
| Nästling | En underordnad delad layout kan själv innehålla `Image` och `Text` -moduler (maxdjup: 2) |
{% hint style="info" %}
Viktigt
Du kan inte placera en Hero Banner, Image Gallery, Filter Menu eller Product Grid i en delad layout.
{% endhint %}
## 5. Bildgalleri
Ett rutnät av bilder med en valfri sektionsrubrik, beskrivning och en nedre CTA.
### Sektionsrubrik
| Fält | Krävs? | Begränsningar |
| ------------------- | ----------------------------------------------------------------- | ------------- |
| Sektionstitel | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | — |
| Sektionsbeskrivning | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | — |
### Gallerilayout
Återförsäljardefinierad per brytpunkt:
| Egenskap | Beskrivning |
| -------- | --------------------------------------------------------------------------------- |
| Kolumner | Antal kolumner på mobil, surfplatta och stationär dator (återförsäljardefinierat) |
| Bildhöjd | Höjd i pixlar eller procent per brytpunkt (återförsäljardefinierat) |
| Avstånd | Avstånd mellan bilder (från återförsäljarens stilguide) |
### Bilder
| Egenskap | Begränsningar |
| ------------------- | --------------------------------------------------------------- |
| Minsta antal bilder | Återförsäljardefinierat (måste lägga till minst så här många) |
| Högsta antal bilder | Återförsäljardefinierat (får inte överskrida detta antal) |
| Format | `GIF`, `JPG`, `PNG`, `SVG` |
| Minsta dimensioner | Återförsäljardefinierat |
| Maximal filstorlek | Återförsäljardefinierat |
| Alt-text | Obligatoriskt eller valfritt per bild (återförsäljardefinierat) |
| Bildtext per bild | Valfritt, max antal tecken: återförsäljardefinierat |
| Länk per bild | `image` (ingen) · `url` · `product` — samma som Bildmodul |
### Ytterligare textrader per bild
Samma som Bildmodulen — återförsäljardefinierade etiketter, teckenstorlekar och valfrihet per rad.
### CTA (längst ned i galleriet)
| Fält | Krävs? | Begränsningar |
| ------------- | ----------------------------------------------------------------- | ------------------------ |
| CTA-knapptext | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | — |
| CTA-länk-URL | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | Måste vara en giltig URL |
| CTA-justering | `left`, `center`, `right` (återförsäljardefinierat) | — |
## 6. Filtermeny
En horisontell navigeringsfält med etiketterade filterobjekt. Använd den för att låta shoppare filtrera innehåll på sidan (till exempel efter kategori eller underkategori).
### Objekt
| Egenskap | Begränsningar |
| ------------------- | ------------------------------------------------------------------------------------------ |
| Minsta antal objekt | Återförsäljardefinierat (måste lägga till minst så här många) |
| Högsta antal objekt | Återförsäljardefinierat (får inte överskrida detta antal) |
| Etiketttext | Max antal tecken: definieras av återförsäljaren |
| Filtervärde | Internt värde som används av filtreringslogiken. Max antal tecken: återförsäljardefinierat |
### Justering
Återförsäljardefinierat. Möjliga värden: `left`, `center`.
Filterobjekt kan sorteras om. Etiketten är vad shopparen ser; värdet är vad som tillämpas som ett filter. De behöver inte vara samma sträng.
## 7. Produktrutnät
Ett utvalt rutnät med produkter som valts ut av varumärket, med valfri sektionsrubrik, filtrering och CTA.
### Sektionsrubrik
| Fält | Krävs? | Begränsningar |
| ------------------- | ----------------------------------------------------------------- | ------------- |
| Sektionstitel | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | — |
| Sektionsbeskrivning | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | — |
### Produkter
| Egenskap | Begränsningar |
| ---------------------- | ------------------------------------------------- |
| Minsta antal produkter | Återförsäljardefinierat |
| Högsta antal produkter | Återförsäljardefinierat |
| Produktkälla | Vald via produktväljaren från varumärkets katalog |
| Visningsordning | Dra och släpp inom modulen |
### Produktkort CTA
Återförsäljaren avgör om en CTA-knapp visas på varje produktkort:
| Inställning | Beteende |
| ----------- | ------------------------------------------------------------------- |
| Inaktiverad | Ingen CTA-knapp på produktkort |
| Aktiverad | En CTA-knapp visas; återförsäljaren ställer in knappens etiketttext |
{% hint style="info" %}
När den är aktiverad delar alla produktkort i rutnätet samma CTA-etikett (inställd av återförsäljaren, inte varumärket).
{% endhint %}
### Filtrering
Återförsäljaren kan valfritt aktivera filtrering på sidan för produktrutnätet:
| Inställning | Beskrivning |
| ------------------- | ---------------------------------------------------------------- |
| `enabled` | Shoppare kan filtrera produktrutnätet |
| `showActiveFilter` | Markerar det för närvarande aktiva filtret |
| `showResultCount` | Visar hur många resultat som matchar det aktiva filtret |
| `emptyStateMessage` | Anpassat meddelande som visas när inga produkter matchar filtret |
{% hint style="info" %}
Filtrering fungerar i kombination med en filtermenymodul. Filtervärden som ställs in på produkter måste matcha filterobjektvärdena i filtermenyn.
{% endhint %}
### CTA (längst ned i rutnätet)
| Fält | Krävs? | Begränsningar |
| ------------- | ----------------------------------------------------------------- | ------------------------ |
| CTA-knapptext | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | — |
| CTA-länk-URL | Krävs, valfritt eller inaktiverat (definieras av återförsäljaren) | Måste vara en giltig URL |
| CTA-justering | `left`, `center`, `right` (återförsäljardefinierat) | — |
## Begränsningsreferens
### `ContentLimit` — begränsningsmodell för textfält
| Värde | Betydelse |
| ----------------------- | ---------------------------------------------------------------------------- |
| `disabled` | Fältet är inte tillgängligt i den här mallen |
| `allowed` + `maxChars` | Fältet är valfritt; om det fylls i får det inte överskrida `maxChars` tecken |
| `required` + `maxChars` | Fältet måste fyllas i; får inte överskrida `maxChars` tecken |
### `ImageConstraints` — begränsningsmodell för bilduppladdning
| Egenskap | Beskrivning |
| ----------------- | ----------------------------------------------------------------------------------------- |
| `altOptionality` | `required` or `allowed` |
| `minWidth` | Minsta bildbredd i pixlar (valfritt) |
| `minHeight` | Minsta bildhöjd i pixlar (valfritt) |
| `maxFileSizeMb` | Maximal filstorlek i megabyte (valfritt) |
| `acceptedFormats` | Delmängd av `GIF`, `JPG`, `PNG`, `SVG` (valfritt — alla accepteras om det inte ställs in) |
### `CtaConfig` — begränsningsmodell för uppmaning (call-to-action)
| Egenskap | Beskrivning |
| ------------- | ----------------------------------- |
| `optionality` | `required` · `allowed` · `disabled` |
| `alignment` | `left` · `center` · `right` |
## Vad som är återförsäljardefinierat kontra fast
| Konfiguration | Återförsäljaren ställer in detta | Fastställt av plattformen |
| ----------------------------------------------- | :------------------------------------: | :-----------------------------: |
| Om en modul kan hoppas över | ✅ | |
| Maximalt antal tecken | ✅ | |
| Lägsta bildmått och maximal filstorlek | ✅ | |
| Vilka bildformat som accepteras | ✅ (delmängd av vad plattformen stöder) | |
| Om CTA krävs, är valfri eller inaktiverad | ✅ | |
| Om överlägg är tillgängligt (Hero) | ✅ | |
| Vilka textjusteringsalternativ som erbjuds | ✅ | |
| Alternativ för kolumnförhållande (Split Layout) | ✅ | |
| Minsta/maximala antal bilder (Image Gallery) | ✅ | |
| Minsta/maximala antal produkter (Product Grid) | ✅ | |
| Tillgängliga modultyper | | ✅ (7 typer, fasta) |
| Medietyp som stöds (Hero) | | ✅ (endast bild; video planerad) |
| Länktyper för bilder | | ✅ (image · url · product) |
| Minsta/maximala nästningsdjup för Split Layout | | ✅ (djup 2) |
| Tillåtna underordnade typer för Split Layout | | ✅ (endast Image och Text) |
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.citrusad.com/retail-media-interface/integration/sv/brand-pages/brand-page-retailer-integration-guide/module-capabilities.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.