> ## Documentation Index
> Fetch the complete documentation index at: https://sella.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Publish your first dataset on Sella: upload to live

> Create a listing, upload your data, run analysis to build a quality datacard, and go live so agents can discover and buy your dataset.

Publishing a dataset on Sella takes only a few minutes. Once live, your listing is discoverable by every agent on the marketplace — each access pays you automatically in USDC. Follow these steps to go from a raw file to a live, earning listing.

<Steps>
  <Step title="Create your account" icon="user-plus">
    Go to [sellag.vercel.app](https://sellag.vercel.app) and sign up. Once you're in, connect or generate a wallet address — this is where your earnings land. You can fund it later; you don't need a balance to publish.
  </Step>

  <Step title="Create a new dataset listing" icon="plus">
    Navigate to **Dashboard → Listings → New → Dataset**. You'll land on the listing creation form. Choose a storage mode before you proceed:

    <CardGroup cols={2}>
      <Card title="Inline" icon="file-text" href="/publishers/datasets">
        Best for small structured datasets. Content is stored in the catalogue record and returned directly in the response body.
      </Card>

      <Card title="Asset-backed" icon="cloud" href="/publishers/datasets">
        Best for large files. Content lives in object storage and buyers receive a short-lived presigned download URL.
      </Card>
    </CardGroup>
  </Step>

  <Step title="Upload your file and fill in metadata" icon="upload">
    Upload your dataset file, then complete the metadata fields. Every field you fill in accurately improves your datacard and helps agents find and trust your listing.

    <AccordionGroup>
      <Accordion title="Name" icon="tag">
        Write a descriptive, keyword-rich title. Agents filter on keywords, so include real column names and the primary use case.
      </Accordion>

      <Accordion title="Description" icon="align-left">
        Explain what the data contains, how it was collected, and what tasks it suits. Agents read this before trialing.
      </Accordion>

      <Accordion title="Schema" icon="table">
        List the fields, types, and any enum values. Agents with `required_fields` set in their `SKILLS.md` check schema before buying.
      </Accordion>

      <Accordion title="License" icon="scroll">
        State the license type and provenance plainly. Ambiguous licensing causes agents to skip a listing. A clear `licenseType` widens your buyer pool.
      </Accordion>

      <Accordion title="Price" icon="coins">
        Set `priceUSDC` — the amount an agent pays per access. Use `0` for a free listing. For paid listings, see the pricing guidance below.
      </Accordion>
    </AccordionGroup>

    <Tip>
      Before setting your price, browse comparable listings with **Dashboard → Listings** sorted by popularity. Pricing at or just below proven listings — while your datacard earns trust — is a reliable way to win early access volume.
    </Tip>
  </Step>

  <Step title="Run analysis to build your datacard" icon="badge-check">
    Save the listing as a draft, then click **Run Analysis**. Sella's ADC pipeline processes your dataset in three passes:

    <Steps>
      <Step title="Structural analysis">
        Detects schema, formats, and completeness — the objective shape of your data.
      </Step>

      <Step title="Quality judging">
        Scores quality signals including task fitness and synthetic probability.
      </Step>

      <Step title="Trial generation">
        Builds the preview payload agents see when they call `try_dataset` — a faithful sample, never your full content.
      </Step>
    </Steps>

    The pipeline produces a `dataCard` on your listing with `structural`, `judge`, and `trial` sections. Agents read this card before deciding to buy, so a strong datacard is your best sales tool.

    <Note>
      While analysis runs, your listing is in `process` state and invisible to agents. It becomes visible only once it reaches `live` or `manual_review`.
    </Note>
  </Step>

  <Step title="Review your qualityStatus" icon="magnifying-glass">
    Once analysis finishes, open your listing and check `qualityStatus`. Aim for **`passed`** — that signals a green datacard and earns better placement in agent search results.

    | Status          | What it means                                                              |
    | --------------- | -------------------------------------------------------------------------- |
    | `passed`        | Clean datacard, fully ready for agents.                                    |
    | `manual_review` | Flagged for a human moderator; still visible in public flows once cleared. |
    | `draft`         | Not yet submitted for processing.                                          |
    | `process`       | Analysis is running; invisible to agents until complete.                   |

    If you don't reach `passed`, improve your metadata or data quality and re-run analysis. You can trigger a re-score at any time without re-uploading the file.

    <Warning>
      Only `live` and `manual_review` listings appear in agent search and listing calls. A listing stuck in `draft` or `process` will never be discovered or purchased.
    </Warning>
  </Step>

  <Step title="Go live and start earning" icon="rocket">
    Once `qualityStatus` is `passed`, your listing moves to `live` automatically. From this point:

    * Agents can **discover** your listing via `list_datasets` and keyword search.
    * Agents can **trial** it with `try_dataset` to inspect the sample before committing.
    * Agents can **purchase** it, triggering an x402 payment that settles to your wallet in USDC.

    You receive **97%** of each paid access; Sella retains a **3% platform fee**. Track your earnings in real time at **Dashboard → Earnings**.

    <Tip>
      After going live, improve your listing's trust over time by keeping metadata up to date and re-running analysis after any data updates. Buyers weight recency of quality signals.
    </Tip>
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Quality & datacards" icon="badge-check" href="/publishers/quality">
    Understand the signals behind your listing's grade and learn how to optimize for a `passed` status.
  </Card>

  <Card title="Pricing & earnings" icon="coins" href="/publishers/pricing">
    Choose the right tier, understand the 3% fee split, and set up withdrawals from your earnings wallet.
  </Card>
</CardGroup>