Skip to content

Configuration reference

Every option the plugin exposes, with its default. All of them live under the odiseo_sylius_marketplace key:

yaml
# config/packages/odiseo_sylius_marketplace.yaml
odiseo_sylius_marketplace:
    notifications:
        enabled: true
        hub_enabled: true
        frequency: 1440
        hub_uri: 'https://hub.odiseo.io/v1/marketplace/version'
    shipping:
        method_owner: vendor          # vendor | operator
    vendor_promotion_enabled: false
    vendor:
        approval_mode: manual         # manual | auto

You only need to declare the keys you are changing — everything else keeps its default.

notifications

Controls the hub notifications shown in the admin panel's notification area, which announce new plugin releases.

OptionDefaultMeaning
enabledtrueMaster switch for notifications.
hub_enabledtrueWhether to poll Odiseo's hub for release announcements.
frequency1440Minutes between hub polls. The default is once a day.
hub_uriOdiseo's endpointThe hub URL to poll.

Hub polling happens only when enabled and hub_enabled are both true, so setting either one to false stops the outbound calls — do that if your environment must not reach Odiseo.

shipping

OptionValuesDefaultMeaning
method_ownervendor, operatorvendorWho defines shipping methods and collects the shipping charge.

Orders always split into one shipment per vendor in both modes — see Shipping in a marketplace for the model and Shipping ownership mode for the trade-offs.

vendor_promotion_enabled

DefaultMeaning
falseWhether vendors can create and manage their own promotions.

Turning it on requires entity and repository changes as well — see Vendor promotions.

vendor

OptionValuesDefaultMeaning
approval_modemanual, automanualWhether a vendor registering from the storefront is approved automatically.

With manual, a new vendor lands in pending and an administrator decides. With auto, the approve transition is applied as soon as they register. In both cases the vendor still has to finish onboarding before going live — see Vendors and their lifecycle.

Environment variables

VariableDefaultMeaning
ODISEO_SELLER_ROUTING_PATH_NAMEsellerBase path of the seller panel. See Seller route prefix.

by Odiseo