Creating and publishing a listing¶

This topic contains procedures for creating and publishing a listing privately or on the Snowflake Marketplace.

Requirements for creating a listing¶

To create a listing, you must follow the steps to become a provider. See Becoming a provider of listings.

Those steps include the following:

  1. Agree to the Snowflake Provider and Consumer Terms.

  2. Review the Provider Policies.

  3. Create a provider profile to offer paid listings or listings on the Snowflake Marketplace.

  4. If you want to charge for your data product, set up your account to provide paid listings.

  5. Get access to a role with provider privileges.

See Becoming a provider of listings for details.

Before you create your listing, prepare the data for your listing. See Preparing data for a listing.

Considerations for sharing listings to accounts in US government regions¶

Providers who want to share listings with consumer accounts in US government regions must consider the following:

Share data or apps with specific consumers using a private listing¶

You can create free or paid listings to share directly with specific consumers. You might create a private listing to fulfill a request from a limited trial listing, or to share data or apps with a consumer with whom you already have a business relationship.

You must know a consumer’s account identifier to share a listing with them. See Finding the Organization and Account Name for an Account.

Note

Your role must have the required privileges to create a listing. See Privileges required for working with listings.

Create a free private listing¶

To create a free private listing, do the following:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Data Products » Provider Studio.

  3. Select + Listing. The Create Listing window opens.

  4. Enter a name for your listing.

  5. In the Who can discover the listing section, select Only specified consumers.

  6. In the How will consumers access the data product? section, select Free.

  7. Select Next.

  8. Choose + Select to select the objects to attach to the listing.

    • If you select one or more database objects, Snowflake creates a secure share with those objects. You can change the name of the secure share.

    • If you select an existing secure share, the name of the share that you select appears.

  9. Enter a description for your listing.

  10. (Optional) If you have multiple provider profiles, select which provider profile to publish this listing as. If you do not select a provider profile, your organization and account name are used.

  11. In the Add consumer accounts section, add the organization and account names for the consumers that you want to share the listing with.

  12. If you add a consumer account in a region that is not your local region, Snowflake enables auto-fulfillment to replicate data to the remote region after a consumer gets your listing. Complete the following additional steps:

    1. In the Auto-fulfillment section, enter a value and select an interval to specify how often to replicate your data product from your region to the remote region.

    2. If you don’t have a default warehouse set, select a warehouse to use for auto-fulfillment.

    See Configuring Cross-Cloud Auto-Fulfillment for more details.

  13. Select Publish to publish the listing to the selected consumers, or select Save Draft to save it as a draft.

Create a paid private listing¶

Creating a paid private listing involves the following steps:

  1. Create a listing.

  2. Configure the listing to prepare it for publishing.

  3. Submit the listing for approval and publishing.

To create a paid private listing, do the following:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Data Products » Provider Studio.

  3. Select + Listing. The Create Listing window opens.

  4. Enter a name for your listing.

  5. In the Who can discover the listing section, select Only specified consumers.

  6. In the How will consumers access the data product? section, select Paid to charge for the listing.

  7. Select Next. A draft listing is created.

Before publishing your draft listing, you must configure additional required and optional capabilities. See Configure a listing.

Convert a direct share to a free private listing¶

You can convert a direct share to a free private listing, or to a listing published on the Snowflake Marketplace. When you do so:

Before you can convert a direct share to a private listing, complete the requirements for providing listings. See Requirements for creating a listing.

To convert a direct share to a private listing, complete the following steps:

  1. Sign in to Snowsight.

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

  3. Select + Listing. The Create Listing window opens.

  4. Enter a name for your listing.

  5. In the Who can discover the listing section, select Only specified consumers.

  6. In the How will consumers access the data product? section, select Free. You cannot convert your share to a paid listing if your share has active consumers.

  7. Select Next.

  8. Choose + Select and locate your direct share. If you do not see your share in the list, confirm that it has not already been attached to a listing.

  9. Enter a description for the listing.

  10. (Optional) Select a provider profile to publish this listing as. If you do not select a provider profile, your organization and account name are used.

  11. (Optional) In the Add consumer accounts section, add consumer accounts to share with. The consumer accounts added to the direct share are automatically added to the listing and display in this section.

  12. If you add a consumer account in a region that is not your local region, Snowflake enables auto-fulfillment to replicate data to the remote region. Complete the following additional steps:

    1. In the Auto-fulfillment section, enter a value and select an interval to specify how often to replicate your data product from your region to the remote region.

    2. If you don’t have a default warehouse set, select a warehouse to use for auto-fulfillment.

    If you decide to use auto-fulfillment to support existing customers in remote regions, see Considerations for existing consumers of direct shares after converting to a listing.

  13. Select Publish to publish the listing to the selected consumers, or select Save Draft to save it as a draft.

After setting up your direct share as a listing, you can use Provider Studio to manage and modify your listing. See Modifying published listings and Monitoring usage of your listing

For steps to create a listing published on the Snowflake Marketplace, see Share data or apps on the Snowflake Marketplace.

Considerations for existing consumers of direct shares after converting to a listing¶

In some cases, your consumers could experience disruptions after you convert a direct share to a listing.

  • If an existing consumer drops the imported database, they must accept the Snowflake Provider and Consumer Terms of Service, if they have not already, to regain access to the data. See Accept the Snowflake Provider and Consumer Terms of Service.

  • If you decide to use auto-fulfillment to support remote consumers of your share, coordinate the following workflow with the remote consumers of your data:

    1. After you publish the listing, let consumers in remote regions know how to access the listing. See Access a private listing.

    2. After the consumers in remote regions get your listing, auto-fulfillment replicates the data to the remote region. See How Cross-Cloud Auto-Fulfillment works.

    3. When auto-fulfillment completes, the consumer receives an email that the data is available. At that point, the consumer must do the following:

      1. Drop the existing imported database created from the direct share.

      2. Get the listing and create a database, using the same name as the database imported from the direct share.

Share data or apps on the Snowflake Marketplace¶

To share data or apps on the Snowflake Marketplace, perform the following steps:

  1. Create a listing.

  2. Configure the listing to prepare it for publishing.

  3. Submit the listing for approval and publishing.

Note

Before you create and publish a paid listing on the Snowflake Marketplace, contact your business development partner at Snowflake. If you do not have a business development partner, submit a case with Marketplace Operations. This step is required for listing approval.

Note

Your role must have the required privileges to create a listing. See Privileges required for working with listings.

To create a listing, do the following:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Data Products » Provider Studio.

  3. Select + Listing. The Create Listing window opens.

  4. Enter a name for your listing.

  5. In the Who can discover the listing section, select Anyone on the Marketplace to publish the listing on the Snowflake Marketplace.

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

    • Free to offer a data product that is freely available to consumers.

    • Limited trial to offer a trial of your data product, with unlimited access to the data product available on request.

    • Paid to charge for your data product on Snowflake.

  7. Select Next. A draft listing is created.

Before publishing your draft listing, you must configure additional required and optional capabilities. See Configure a listing.

Configure a listing¶

You must provide additional details for paid private listings and any listing offered on the Snowflake Marketplace before you can submit your listing for approval or publish it to specific consumers.

To configure a listing, do the following:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Data Products » 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 Configuring listings for information on each field. The specific properties available to edit depend on the type of listing that you create.

Publishing a listing¶

After creating and configuring a listing, you can publish a listing.

The specific procedures for publishing a listing depend on whether you’re publishing a free private listing, offering a paid listing privately, or offering any listing on the Snowflake Marketplace:

To publish a listing, you must use the ACCOUNTADMIN role or another role with the OWNERSHIP privilege for the listing that you want to publish.

When you publish a listing, it is visible to consumers in all current and future Marketplace regions, but consumers can only get, purchase, or request your product in regions you select.

Publish a listing to specific consumers¶

To share a private listing with specific consumer accounts, you must publish the listing to those accounts. Private listings do not appear on the Snowflake Marketplace.

To publish a listing shared with specific consumers, do the following:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Data Products » Provider Studio.

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

  4. Select Publish.

After you publish the listing, the listing is available for the selected consumers to access from Private Sharing. See Accessing and installing listings as a consumer.

Note

After you publish a private listing, you cannot change the share associated with the listing.

Publish a listing on the Snowflake Marketplace¶

Every listing in the Snowflake Marketplace must go through the review and approval process. After a listing is approved, it can be published in the Snowflake Marketplace. If a listing is rejected, review the feedback comments, update the listing, and resubmit it for approval.

Submit your listing for approval¶

Before you can publish a listing to the Snowflake Marketplace, you must submit the listing to Snowflake for approval.

If you want to submit your listing for approval but the option to Submit for Approval is disabled, check the following:

  • You completed the steps to configure the listing. See Configure a listing.

  • You are the ACCOUNTADMIN or have the OWNERSHIP privilege for the data product attached to the listing.

  • All sample SQL queries attached to the listing pass validation.

To submit a listing for approval, do the following:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Data Products » 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.

    When a listing is approved or denied, an email notification is sent to both the Business Contact and Technical Contact email addresses in the provider profile associated with the listing.

Publish your listing¶

After a listing is approved, publish it on the Snowflake Marketplace:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Data Products » Provider Studio.

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

  4. Select Publish.

After you publish your Snowflake Marketplace listing for the first time, subsequent changes to the listing that require approval from Snowflake are published automatically after approval. To prevent your listing from being automatically published, see Deactivate automatic publishing.

When you publish a listing, it is visible to consumers in all current and future Snowflake Marketplace regions. Consumers can only get, purchase, or request your product in regions you select. See Configuring Cross-Cloud Auto-Fulfillment for more about region availability.

After publishing your Snowflake Marketplace listing, you can define a referral link for the listing. Referral links let you give consumers a direct link to your listing.

Deactivate automatic publishing¶

After a listing is published, you can deactivate automatic publishing for future changes to the listing.

To deactivate automatic publishing, do the following:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Data Products » Provider Studio.

  3. Select the Listings tab, then select the approved listing for which you want to deactivate automatic publishing.

  4. On the listing details page, select Settings.

  5. In the Publishing section of the Listing Settings, select Edit Publishing.

  6. In the Publish Settings dialog, select Manual.

  7. Select Save.

The listing is no longer automatically published. Now, when you make changes to your listing, you must manually publish the listing. See Publish your listing.

Share private listings with consumers using VPS¶

Note

This feature is not enabled for all accounts. To request, please contact Snowflake Support.

If you are a provider in 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
    Copy

    See SHOW ORGANIZATION ACCOUNTS for details.

  2. Create a private listing for the consumer. See Share data or apps with specific consumers using a private listing. Save the listing as a draft.

  3. After the VPS consumer contacts you, update the listing to add the organization account(s) requested by the VPS consumer.

  4. Publish the listing to share it to the specified accounts. See Publishing a listing.

For the steps that VPS consumers must follow to allow you to share private listings, refer to Allow providers to share private listings into your VPS.

Language: English