Marketplace

Shop Profile & Publishing

How your shop appears to buyers, and which of your products are in its window.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/marketplace/shop-and-products

Requires subscriptionmarket.publish10,000 IQD / month

Set up the shop

  1. 1

    Open Marketplace → Shop profile

    The first time, the page asks you to set up your shop.

    Marketplace — Shop profile
    Shop profile
    Shop profile — The shop profile form — address, name, description, city, phone, WhatsApp — and the two visibility switches.
  2. 2

    Choose the shop address

    The short name in your shop's link, shown as a preview while you type. Lowercase letters, numbers and dashes, 3 to 50 characters, not starting or ending with a dash. An address already taken by another shop is refused.

  3. 3

    Fill in the details

    Shop name (required), a description of what you sell and where you deliver, city, phone and WhatsApp.

  4. 4

    Save

    The shop is saved but stays hidden until you switch it on.

  5. 5

    Publish some products, then switch the shop on

    Turn on “Shop is on the marketplace” when the window is ready.

Shop fields

PUT /api/v1/market-admin/profile
ParameterTypeRequiredDescription
Shop addressslugRequiredThe link buyers use to find you. Unique across the marketplace.
Shop namestringRequiredThe name shown on your shop page and on orders.
DescriptionstringOptionalWhat you sell, who you sell to, delivery areas.
CitystringOptionalBuyers can filter shops by city.
PhonestringOptionalThe number buyers see for your shop.
WhatsAppstringOptionalA WhatsApp number for buyers.

Visibility

ParameterTypeRequiredDescription
Shop is on the marketplaceswitchRequiredOn — buyers can find your shop, see your published products and send you orders. Off — your shop and all its products are removed from the marketplace immediately, and buyers cannot send new orders.
Show pricesswitchOptionalOn — buyers see your selling price on every published product. Off — buyers see “Price on request” instead.
NoteSwitching the shop off is the quick way to pause — for a holiday or a stock-take — without unpublishing anything. Your published list is kept exactly as it was.
WarningWith prices off, an order arrives with no prices and no total on it. You agree the price with the buyer when you call them.

Publishing products

Marketplace — Products
Products
Products — The product list with what buyers see, the in-stock badge and the published switch, with the count of products published.

The Products tab lists your catalogue. Search, filter by category, and publish or unpublish one product with its switch — or tick several (or Select all on this page) and use Publish or Unpublish. The header shows how many of your products are published.

Columns
ParameterTypeRequiredDescription
ProductstringOptionalThe product, with its unit.
CategorystringOptionalIts category in your catalogue.
Buyers seepriceOptionalThe price a buyer is shown — or “Price on request” when prices are off or the product has no price.
StockbadgeOptionalIn stock or Out of stock — the same yes/no the buyer sees.
On marketplaceswitchOptionalWhether this product is published.

What is published about a product

  • Its name, unit, category and image, as they are on the product.
  • Its selling price, if prices are shown.
  • Whether it is in stock — never how many.
TipNothing is copied. A published product is your product, shown to buyers: change its name, price or image in Products and the marketplace follows. When it runs out of stock it shows as out of stock, and buyers cannot add it to a cart until you have stock again.
Endpoints — /api/v1/market-admin
ParameterTypeRequiredDescription
GET /profileendpointOptionalThe shop profile — empty until the shop has been set up.
PUT /profileendpointOptionalSave the shop profile.
GET /listingsendpointOptionalYour products with their published state.
POST /listings/publishendpointOptionalPublish a list of products.
POST /listings/unpublishendpointOptionalUnpublish a list of products.

Related