Creating and Publishing a Listing

This topic contains procedures for creating and publishing a listing.

In this Topic:

Requirements

The following are requirements to create and publish listings:

  • To use the Listing Discovery Controls capability, you must agree to the Provider Terms of Service.

  • For listings that are published to the Snowflake Marketplace, ensure that you have completed the provider onboarding process.

  • For free (or paid off-platform) private listings, you must ensure that you have accepted the Provider Terms of Service. For monetized private listings ensure that you have completed the provider onboarding process.

Prerequisites

To create and publish a listing you must use one of the following roles:

  • ACCOUNTADMIN, or

  • A custom role with the following global privileges:

    • CREATE DATABASE

    • IMPORT SHARE

Before creating a listing, identify the objects that you want to share. You can create a secure share for the objects before you create a private listing or select the objects using the web interface.

Creating a Listing

To create a listing perform the following procedures:

  1. Sign in to Snowsight.

  2. In the left navigation bar, select Data » Provider Studio » Listings.

  3. Select the Home tab, then select + Listing.

  4. In the Create Listing window, enter a name for your listing.

  5. In the Who can discover the listing section, select one of the following options:

    • Anyone on the Marketplace: indicates that published listing will be available in the Snowflake Marketplace.

    • Only specified consumers: indicates that the listing is a private listing and is available only to specific accounts.

  6. In the How will consumers access the data product? section, select one of the following options:

    • Free: indicates a listing that is freely available to consumers.

    • Paid: indicates a listing that consumers must pay to use.

    • Personalized (Marketplace listings only): if you select to publish your listing to the Snowflake Marketplace, you can select this option.

  7. Click Next.

    If you are creating a Marketplace listing or a paid private listing, the listing is created in draft mode. You can configure additional required and optional capabilities for the listing before publishing.

    If you are creating a free private listing you can select Save as Draft or publish the listing directly by performing the following procedures:

    1. Under What’s in the Listing, click +Select.

    2. Select the secure share you want to add to the listing, then select Done.

      The Secure Share Identifier is displayed.

    3. Add a description of your listing.

    4. Under Publishing as, select the profile or account you want to associate with the listing.

    5. Under Add consumer accounts, add the accounts you want to have access to the private listing.

    6. If you add a consumer account in a region that is not your local region, under Auto-fulfillment, enter a value and select an interval to specify how often the data is replicated to the remote region.

      Note

      If you add a consumer account in a region that is not your local region, auto-fulfillment is enabled automatically. Data in the remote region is replicated only after the consumer requests the data. See Considerations when Using Listing Auto-fulfillment.

    7. Click Publish.

Note

Until a listing is published, it can only be associated with a share in the local/primary account.

Configuring a Listing

After creating a listing you can configure capabilities by performing the following:

  1. Sign in to Snowsight.

  2. In the left navigation bar, select Data » Provider Studio.

  3. Select the Listings tab, then select the draft listing you want to configure.

  4. Select Add next to each section that appears on the page and provide the required information.

    As you provide information for each section, refer to Listing Capabilities Reference for information on each field.

    Note

    The specific sections that are available depend on the capabilities you selected when creating the listing.

    See the following for additional information on configuring different listing capabilities:

Publishing a Listing

After creating and configuring a listing, you can publish a listing. The specific procedures for publishing a listing depend on the listing capabilities you selected when creating the listing.

Publishing a Private Listing

To publish a listing shared with specific consumers:

  1. Sign in to Snowsight.

  2. In the left navigation bar, select Data » Provider Studio.

  3. Select the Listings tab, then select the draft listing you want to publish.

  4. Select Publish.

The listing is now available for consumers to access under Private Sharing.

Note

After a private listing is published, you cannot change the share that you selected when you created the listing.

Publishing a Marketplace Listing

Before you can publish a listing to Marketplace, you must submit the listing to Snowflake for approval. After configuring your listing , the Submit for Approval button is enabled, except in the following situations:

  • You are not the owner of the data share added to the listing.

  • Any of the provided sample SQL queries fail validation.

To publish a listing to Marketplace:

  1. Sign in to Snowsight.

  2. In the left navigation bar, select Data » Provider Studio.

  3. Select the Listings tab, then select the draft listing you want to submit for approval.

  4. Select Submit for Approval.

  5. After the listing is reviewed by Snowflake, the state changes to Approved or Denied.

    If the listing has been denied, update the listing based on the feedback provided in comments, and resubmit it for approval.

    Snowflake data providers are notified when their listing is approved or denied. An email notification is sent to both Business Contact and Technical Contact email addresses in the provider profile associated with the listing.

  6. Select Publish.

Publishing a Personalized Listing

By default, Snowflake automatically publishes your personalized listings after they are submitted and approved. No further steps are required.

Share Private Listings with Consumers Using VPS

If you are a provider in the Snowflake Marketplace and want to share listings with consumers with Virtual Private Snowflake (VPS) accounts, do the following:

  1. Share your organization name and account locator with the VPS consumer. If you don’t know your organization name or account locator, run the SQL command:

    SHOW ORGANIZATION ACCOUNTS
    

    See SHOW ORGANIZATION ACCOUNTS for details.

  2. Create a private listing for the consumer. See Creating a Listing. Save the listing as a draft.

  3. After the VPS consumer contacts you, share the private listing with the organization account(s) requested by the VPS consumer.

For the steps that VPS consumers must follow to allow you to share private listings, see Allow Providers to Share Private Listings into Your VPS.

Back to top