Listings Capabilities Reference

This topic describes the fields for capabilities that you can configure for a listing. Depending on whether you offer a paid listing, a private listing, or a marketplace listing, you must complete different fields.

After you configure the listing, publish the listing. See Publishing a Listing.

In this Topic:

Basic Information

The following table describes the available fields in the Basic Information section.

Field Name

Description

Example

Type

The type of listing. After you create a listing and attach a share, you cannot change the listing type.

Available Values: Free, Personalized, or Paid.

Publishing as

The provider profile used to publish the listing to consumers. You must create a provider profile before you can publish a listing. See Becoming a Provider of Listings.

Title

The title of the listing. The listing title cannot exceed 110 characters, but it is recommended that the title is between 40-60 characters. All major words should be capitalized (i.e. follow the title case format).

The title appears below your company name on the listing tile, and it must be unique (i.e. different from any other listings you may have).

If you decide to offer similar listings, such as a Free listing to showcase a subset of your data, and a Personalized listing to let consumers request the full dataset, use similar but distinct titles. In this example, you could append - Sample to the Free listing title.

If you provide free listings to showcase other listings on the Snowflake Marketplace, use a - Demo or - Sample suffix.

If you provide free listings for a limited time, use a - Trial suffix.

This option is not available for free (or paid off-platform) private listings.

Historical Weather by Postcode.

Subtitle

Subtitle for the listing. The subtitle cannot exceed 110 characters. Use sentence case for the subtitle and do not repeat the title.

This option is not available for free (or paid off-platform) private listings.

Historical weather data by location.

Category

Listings are categorized to make them easy to find on the Snowflake Marketplace. Select the desired category from the drop-down list of available values.

This option is not available for free (or paid off-platform) private listings.

Terms of Service

Specifies a link to the Terms of Service agreement for the listing. Consumers must accept the terms before they can access the listing. Terms of Service agreements are required for free listings, and are optional for personalized listings.

Select one of the following:

  • Standard Agreement for Marketplace Products: Snowflake provides a standard terms of service agreement for Snowflake Marketplace products, called the Standard Agreement for Marketplace Products. This agreement is available at: https://www.snowflake.com/marketplace/standard-agreement/. You can choose to use the Standard Agreement as the terms of service agreement for your listing. You can learn more about the Standard Agreement by reviewing the FAQs available at: https://www.snowflake.com/standard-agreement-for-marketplace-products/.

    By selecting the Standard Agreement for Marketplace Products, you’re confirming that you’ve reviewed it and the Disclaimer with your legal counsel.

  • Custom: Lets you specify a URL to a terms of service agreement for your listing.

https://www.example.com/en/legal

Details

The following table describes the available fields in the Details section.

Note

This section is optional for private listings.

Field Name

Description

Example

Description

Description of the data product shared in the listing. Enter a description between 250 and 6000 characters, with line breaks between paragraphs. Use dashes instead of bullet points. The description must include the following: . - An introductory paragraph with information about the data product, such as the scope of the dataset. . - A description of included tables or views . - Key data fields . For listings that include services or secure functions, the description must include the expected workflow for consumers to access your services or secure functions. . The description can also include the data sources for your listing, or additional information not covered in other fields.

ACME is the number one supplier of customized, pinpoint weather warnings to large enterprises, as well as a vital information source for worldwide weather forecasts, data and meteorological consulting services. This listing provides historical weather data for US zip codes that can be used to further enhance your existing data to provide deeper analytics. . Samples/tables included: . - Daily historical weather data from 2016-Present . - 15-day Daily Forecast weather data . - Daily 15-year climatology data (weather statistics, i.e. avg, std, freq, etc.) . Fields included: . - Date . - Zip Code . - Country . - Min, Max, Avg weather statistics (temperature, precipitation, wind, humidity, etc.)

Link to Documentation

A link to a page on your website with more detailed documentation for the listing. Documentation must be clear, and reference the correct schema objects present in the share associated with the listing. The link must be accessible on the internet, and not require authentication to access.

https://developer.acme.com

Data Product - Secure Share

The Data Product - Secure Share section enables you to configure the share that is associated with a listing. See Prepare the Shares For Your Listing for paid listings.

  • Secure shares can only be attached to one listing.

  • After the listing is published, you cannot attach a different share.

  • You can only see shares owned by your current role — ACCOUNTADMIN.

  • The data product must be legally shareable (i.e. you must own the data or have the right to share it).

  • Until a listing is published, it can only be associated with a share in the local/primary account. After the listing is published, it can be associated with a share in additional regions that you have selected.

Field Name

Description

Database Objects or Secure Share

Data that you want to share as part of the listing.

This section is not available for personalized listings.

Data Product - Attributes

After specifying a data product, you can define additional attributes for a listing.

Note

This section is optional for private listings.

Field Name

Description

Update Frequency

How often your data product is updated in Snowflake

Geographic Coverage

What geographic area the data covers.

Time Range

The range of time that the data covers.

Additional attributes (optional)

Any additional information that you want to communicate to your consumers. For example, include a description of the scope and scale of your data, and why someone might find your data useful.

Data Product - Trial & Pricing (Paid Listings Only)

Add the pricing plan and trial for your listing in this section. This section is required for paid listings offered on the Snowflake Marketplace, but trials are optional for paid private listings.

Note

Only account administrators (users with the ACCOUNTADMIN role) or the listing owner (a role with OWNERSHIP privilege on the listing) can complete this section.

The following table describes the available fields in the Trial & Pricing section.

Field

Description

Free Trial

Choose the trial type for the listing:

  • Limited functionality: This option lets consumers participate in a free trial with limited functionality of the paid data product. This trial mode doesn’t expire until the consumer upgrades to the paid listing.

  • Limited time: This option lets consumers participate in a free trial for a specific time period that you specify (1, 7, 30, 60, or 90 days). The maximum trial period is 90 days. When the trial ends, the consumer account loses access to the data product. Other accounts in the same organization can perform a new trial of your listing.

  • Limited functionality and time: This option lets consumers participate in a free trial for a specific period that you specify (1, 7, 30, 60, or 90 days). The trial version offers limited functionality of your data product, and when the trial period ends, the account performing the trial loses access to the data product.

Pricing Plan

Choose the pricing plan for the listing. See Pricing Model Components. Prices are currently in US dollars only.

Business Needs

The following table describes the available fields in the Business Needs section.

Note

This section is optional for private listings.

Field Name

Description

Business Need

Listings are grouped by business needs to make them easy for consumers to discover on the Snowflake Marketplace. You can select up to six relevant business needs for your listing.

If you do not see a relevant business need in the drop-down list, you can create a custom one. However, custom business needs that you create are only visible in your listing details. Consumers cannot filter by custom business needs on the Snowflake Marketplace.

You can edit the list of business needs at any time without resubmitting the listing for approval.

Description

Description of how your listing addresses the selected business needs.

Sample SQL Queries

You can specify a valid sample SQL query that consumers can use to verify that your data product was successfully installed in their Snowflake account.

Note

A valid SQL query is required in order for you to publish a Marketplace listing. SQL queries are optional when publishing private listings.

The sample SQL has the following requirements:

  • The query must return at least one row.

  • The query must reference objects that are explicitly in the share.

  • Objects must be qualified using SCHEMA.OBJECT. Do not include the database name. For example, EXAMPLE_SCHEMA.TABLE_A.

The following table describes the available fields in the Sample SQL Queries section.

Field Name

Description

Example

Title

Descriptive title for the query to help consumers understand the data. You can add more than one example.

Determine if an outdoor event could be affected by rain.

Description (Optional)

Description of the example with additional instructions, such as the name of the schema, sample tables, fields, or use cases. Use <schema>.<table> format when referencing tables and views in your SQL. Do not include the database name in the query, because customers can create custom database names when they get your listing.

If you are hosting an outdoor event in the next 7 days, use our forecast data to determine if the event might be affected by rain.

SQL Query

Code for your sample SQL queries. Snowflake automatically validates your sample queries. To be valid, a sample query must return at least one row. If a query fails to validate, you can save the listing but the listing cannot be published until all sample queries are successfully validated. You must select a warehouse to use to validate the SQL query.

Region Availability (Marketplace Listings Only)

The following table describes the available fields in the Region Availability section.

Field Name

Description

Global Availability

  • If Global Availability is On (default):

    By default, a listing is available for consumers to get, purchase, or request in all current Marketplace regions. The listing is automatically available in any region that Snowflake adds in the future.

    Selecting Global Availability for your listing doesn’t automatically replicate your listing’s product. You can edit the Region Availability at any time without re-submitting the listing for administrator’s approval. If you remove a region where the listing was previously available, consumers in that region will no longer be able to get, purchase, or request the listing’s product, though the listing remains visible to all consumers.

  • If Global Availability is Off:

    By turning off Global Availability, you can select the specific regions in which to make your listing available for consumers to get, purchase, or request. The listing is not automatically available in regions that Snowflake adds in the future.

Paid listings cannot be made globally available. Instead, select from the Available Regions.

Data Product Fulfillment to Available Regions

Choose between the following options:

  • Automatic (recommended)

    Your data product will be automatically replicated and incur costs only when there is consumer demand in an available region. If you select this option, you must also select a refresh frequency at which to sync your data product. You must select a refresh frequency of at least 8 days.

  • Manual

    To fulfill requests, you must manually set up accounts in available regions, manually replicate the product to each account, create secure shares in each account, and attach those shares to this listing.

See Configuring Cross-Cloud Auto-fulfillment for more details about these options.

Consumer Accounts (Private Listings Only)

If you are configuring a private listing, you must configure the fields in the following table.

Field Name

Description

Example

Consumer Accounts

Specifies the Snowflake accounts that you want to share your private listing with. You can use Snowflake account identifiers or URLs.

ORGABC.ACCOUNT123 https://<organization_name>-<account_name>.snowflakecomputing.com

If you’re sharing with a consumer account that is in a different region than your account, you must also set up auto-fulfillment:

Field Name

Description

Auto-fulfillment

Select the replication interval and frequency for your data product. For example, you can configure replication to occur every two hours.

See Configuring Cross-Cloud Auto-fulfillment for more information.

Back to top