Share an app with consumers

After developing and testing the application package containing your application , you can publish the application to consumers using listings.

As a provider, you add an application package as the data content of an listing. The consumer installs the application in their account from the listing.

Set up roles and privileges

When you create a listing, you create it from the account that has the data or application package in it. The role that attaches a data product to a listing and publishes the listing must be the same role that created, and therefore owns, the application package or share. You cannot transfer the OWNERSHIP privilege for a share.

If you use a different role to create and manage the listing, grant the MODIFY privilege on the listing to the role that owns the application package or share. For example:

Share or application package owner role:

OWNERSHIP privilege on the share or application package. MODIFY privilege on the listing.

Listing owner role:

OWNERSHIP privilege on the listing. Global CREATE DATA EXCHANGE LISTING privilege.

Within the provider account, you can use one of the following to create and manage listings:

ACCOUNTADMIN:

If you use the ACCOUNTADMIN role to create and manage listings, the ORGADMIN role must first delegate privileges to set up auto-fulfillment.

Custom role:

If you use a custom role, the ORGADMIN role must first delegate privileges to set up auto-fulfillment to the ACCOUNTADMIN role, which can then be used to grant the relevant privileges to the custom role.

Some privileges can only be granted using Snowsight, while others can be granted using SQL or Snowsight.

Task

Required privileges

Grant using

Create a provider profile

Global CREATE DATA EXCHANGE LISTING privilege.

SQL or Snowsight

Manage or update a provider profile

The OWNERSHIP or MODIFY privilege on the profile.

Snowsight

Modify listing capabilities and properties

The OWNERSHIP or MODIFY privilege on the listing.

Snowsight

View a listing

The OWNERSHIP, MODIFY, or USAGE privilege on the listing.

Snowsight

Attach a share to a listing

OWNERSHIP of the share and OWNERSHIP or MODIFY privileges on the listing.

Snowsight

Set up auto-fulfillment for a listing

The account-level MANAGE LISTING AUTO FULFILLMENT privilege granted by an ACCOUNTADMIN with delegated privileges, and OWNERSHIP or MODIFY privileges on the listing.

SQL

Fulfill a listing request

OWNERSHIP or MODIFY privileges on the listing.

Snowsight

For more information about granting sharing privileges, see Granting Privileges to Other Roles.

Prerequisites for publishing a listing for an application package

Before creating a listing for an application package, ensure that you have completed the following:

  • Create and test your application package.

    Before publishing your application package, ensure that it is working correctly and that the roles and privileges are set properly.

  • Become a Provider of Listings

    Becoming a provider of listings in Snowflake makes it easier to manage sharing applications from your account to other Snowflake accounts. See Becoming a provider of listings.

    Creating a provider profile is not required for private listings.

Workflow for publishing an application package

To publish an application package:

  1. Ensure that you have completed the prerequisites for publishing a listing for an application package.

  2. Set the default release directive.

  3. Initiate the automated security scan.

  4. Create a listing.

  5. (Optional) Add a pricing plan to get paid for your application.

  6. Submit your listing for approval.

    You only need to approve listings published to the Snowflake Marketplace.

  7. Publish your listing.

Set the default release directive

Before creating a listing for an application package, you must specify the default release directive for the application package. You can set the default release directive using SQL.

Initiate the automated security scan for an application package

To publish a listing for an application package to an account outside of your organization, your application package must pass an automated security scan.

Refer to Initiating an Automated Security Review.

Create a listing for an application package

To share your application with consumers, create a listing for your application package.

Create a private listing for an application package

To offer your application package to specific consumers, create a listing:

  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 to privately share the listing with specific accounts.

  6. Click + Select to select the application package to be in the listing.

  7. Enter a description for your listing.

  8. (Optional) If you have multiple provider profiles, select which provider profile to use to publish this listing.

  9. In the Add consumer accounts section, add the account identifiers for the consumers with whom you want to share the listing.

  10. If the consumer accounts are located in another region, set up auto-fulfillment:

    1. Review the refresh frequency configured at the account level. If you need to use a different refresh frequency, see Set account-level refresh frequency.

    2. Optionally select a warehouse to use to set up auto-fulfillment.

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

To monetize your application, add a pricing plan to get paid for your application.

Create a listing for an application package for the Snowflake Marketplace

To offer your application package on the Snowflake Marketplace, create a listing:

  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 Free or Paid.

  7. Select Next. A draft listing is created.

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

Configure a Snowflake Marketplace listing for an application package

After you create a listing for the Snowflake Marketplace, you must configure additional information for your listing so that you can submit it for approval and publish it.

To configure a listing:

  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.

    If you want to monetize your Snowflake Native App, add a pricing plan to get paid for your Snowflake Native App.

Submit a 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.

  • 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:

  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.

    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 a listing for an application package

To publish an approved listing 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 listing you want to publish.

  4. Select Publish.

After publishing your Snowflake Marketplace listing, you can define a referral link to share a direct link to your listing with consumers.