> ## Documentation Index
> Fetch the complete documentation index at: https://afrizon-admin.tunzaa.co.tz/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage vendor stores and storefronts in Meneja

> View and edit each vendor's store branding, promotional banners, product categories, and store policies from the vendor's profile in Meneja.

Each vendor on your platform can have one or more stores. A store is the customer-facing storefront that shoppers browse and buy from. You configure the store's identity — its name, description, visual branding, promotional banners, product categories, and policies — from the vendor's profile in the Meneja dashboard. Changes you make here are reflected immediately in the store's public presentation.

## Store fields

Each store record contains the following fields, which you can view and edit from the vendor's profile.

| Field             | Description                                                             |
| ----------------- | ----------------------------------------------------------------------- |
| `store_id`        | Unique identifier for the store                                         |
| `store_name`      | Display name of the store as seen by shoppers                           |
| `description`     | Short description of the store and what it sells                        |
| `branding`        | Visual identity settings — see [Store branding](#store-branding)        |
| `banners`         | List of promotional banner images — see [Store banners](#store-banners) |
| `categories`      | Array of category IDs that the store sells within                       |
| `general_policy`  | General terms and conditions for the store                              |
| `return_policy`   | The store's return and refund policy                                    |
| `shipping_policy` | The store's shipping and delivery policy                                |

## Viewing a vendor's stores

<Steps>
  <Step title="Open the vendor profile">
    Navigate to **Vendors** in the sidebar and click the vendor whose stores you want to manage.
  </Step>

  <Step title="Go to the Stores section">
    On the vendor detail page, select the **Stores** tab or section. Meneja loads all stores associated with that vendor.
  </Step>

  <Step title="Select a store">
    Click on a store to view its full details, including branding configuration, banners, categories, and policies.
  </Step>
</Steps>

## Editing a store

<Steps>
  <Step title="Open the store">
    From the vendor's Stores section, click the store you want to edit.
  </Step>

  <Step title="Update store details">
    Edit any of the store's fields: name, description, categories, branding, banners, or policies. All fields are optional except `store_name` (minimum 2 characters) and `description`.
  </Step>

  <Step title="Save changes">
    Click **Save** to apply the updates. Changes take effect immediately.
  </Step>
</Steps>

<Note>
  At least one category must be selected for a store. Categories connect the store's products to the correct browsing sections on the marketplace.
</Note>

## Store branding

Store branding controls the visual identity of the storefront.

| Field         | Description                                          |
| ------------- | ---------------------------------------------------- |
| `logo_url`    | URL of the store's logo image                        |
| `favicon_url` | Optional URL of the store's favicon                  |
| `colors`      | Color palette used across the storefront — see below |

The `colors` object contains the following fields:

| Color field  | Description                                                |
| ------------ | ---------------------------------------------------------- |
| `primary`    | Primary brand color (e.g. used for buttons and highlights) |
| `secondary`  | Secondary brand color                                      |
| `accent`     | Accent color for special elements                          |
| `text`       | Default text color                                         |
| `background` | Page background color                                      |

<Tip>
  Use hex color values (e.g. `#4285F4`) for consistent rendering across browsers and devices.
</Tip>

## Store banners

Banners are promotional images displayed prominently on the store's homepage. Each banner has the following fields:

| Field           | Description                                             |
| --------------- | ------------------------------------------------------- |
| `title`         | Banner title (required)                                 |
| `image_url`     | URL of the banner image (required)                      |
| `alt_text`      | Descriptive text for the image, used for accessibility  |
| `display_order` | Numeric value that controls the order banners appear in |

A store can have multiple banners. Meneja renders them in ascending `display_order` order.

<Warning>
  Banners require both a `title` and an `image_url`. Submissions without these fields will fail validation.
</Warning>

## Store policies

Stores have three distinct policy fields, all optional:

| Policy field      | Purpose                                                         |
| ----------------- | --------------------------------------------------------------- |
| `return_policy`   | Describes the conditions under which customers can return items |
| `shipping_policy` | Explains shipping methods, timelines, and costs                 |
| `general_policy`  | Covers any additional terms and conditions for the store        |

You can enter policy text directly into the form fields when editing a store. Policies are surfaced to shoppers on the store's policy pages.