App Listing Schema

An App Listing is a block of JSON-LD on the homepage of your application. Put the schema object inside of a <script type="application/ld+json"> tag so the @Store can index it.

Either create your schema by hand, or use the Listing Builder.

  <script type="application/ld+json">
  {
    "@context": "https://store.stucco.software/schema",
    "@type": [...Types]
    "title": String,
    "subtitle": String,
    "category": [...String],
    "price": {
      "amount": Number,
      "period": String
    },
    "purchases": Boolean,
    "developer": URL,
    "language": [...Lang],
    "logo": URL,
    "previews": [...URL],
    "description": String,
  }
  </script>
  

@context

Always use the URL https://store.stucco.software/schema. This is the schema definition.

@type

Must include "Application". If your app supports ATProto, also include "ATProto". If your app supports Solid, also include "Solid".

Title String

The name of your application, displayed at the top of your listing.

Subtitle String

A short description of what your app is, displayed below the title.

Description String

A longer description of your application, displayed on your app listing page. Accepts Markdown.

Category [...String]

An array of category terms, used to classify and find your app. Examples incluide `["Finance"]` or `["Productivity", "Utillities"].

Price Object

Used to display the price – in USD – of your app, either free, one-time purchase, or a subscription.

Free

{
  price: 0
}

One-Time Purchase

{
  price: 39
}

Subscription

{
  price: 8,
  period: "Month"
}

Purchases Boolean

Used to indicate if there are additional purchases within the application.

Developer URL

The application developers website.

Language [...Lang]

An array of language codes, for eample ['en-us'].

Logo URL

A URL to an image for your apps logo.

Previews [...URL]

An array of URLs to images of your application, displayed on your app listing page.