Marketplace Content Sharing Rules

Introduction

This document explains how content is shared between stores in the Publica.la marketplace through ONIX feeds. Understanding these rules is essential for content owners who want to control which stores can access and sell their publications.

Marketplace Visibility Control

Content sharing in the marketplace is determined by the most recent ONIX file processed for each issue. Whenever a new ONIX file is processed, it completely replaces previous sharing settings for the affected content.

SalesOutlet Field

The SalesOutlet field in ONIX determines whether content is visible in the marketplace:

• When SalesOutlet contains "Marketplace", the content is enabled in the marketplace
• If "Marketplace" is not included in SalesOutlet, the content won't be visible in the marketplace
• If this value changes in a subsequent ONIX, the visibility will be updated accordingly

This feature provides granular control over marketplace visibility on a per-content basis.

Force Show Marketplace Flag

The "Force Show marketplace" flag in intake configuration affects how the system handles marketplace visibility:

• When set to TRUE:

  • All content processed through the intake is shared in the marketplace regardless of the SalesOutlet value
  • This overrides individual content settings in the ONIX files

• When set to FALSE:

  • Content visibility follows the SalesOutlet field values
  • If SalesOutlet includes "Marketplace", the content is shared in the marketplace
  • If SalesOutlet is empty or does not include "Marketplace", the content is removed from the marketplace (if previously shared) or not shared at all

Tenant Permission Requirements

Beyond the ONIX configuration, proper content sharing in the marketplace requires explicit permission settings in NOVA:

1. Go to the content owner's NOVA Dashboard
2. Navigate to Permissions > Content Permissions
3. Click Create Tenant Content Permission
4. Select ONIX Share as the Permission Type
5. Choose the target tenant in the Target Tenant ID field
6. Save by clicking Create & Add Another or Create Tenants Permission

info

This permission enables sharing capability but doesn't automatically share content. The content owner must still specify what to share via the ONIX Intake using the methods described above.

warning

Even if the SalesOutlet field includes "Marketplace" or the "Force Show marketplace" flag is enabled, content will not be shared with stores that don't have the proper NOVA permissions set up.

ONIX Processing Behavior

Dynamic Store Sharing

When an ONIX file is processed, the system updates store sharing according to the new information:

• If a publication was previously shared in marketplace but is not present in the new ONIX, the content will be removed from marketplace.
• If a new publication is added to the ONIX, the content will be shared automatically in marketplace.
• Only publications explicitly listed in the most recent ONIX will have access to the content

Example

Day 1: Content is shared with stores A, B, and C through ONIX
Day 2: A new ONIX is sent for the same content, specifying only stores A and B
Result: The content is now only shared with stores A and B, and is no longer available to store C

---