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:
Agree to the Snowflake Provider Terms of Service.
Review the Provider Policies.
Create a Provider Profile to offer marketplace or paid listings.
Set up billing for your account, if you want to create paid listings.
Get access to a role with provider privileges.
See Becoming a Provider of Listings for details.
Creating a Private Listing¶
You can create free or paid private listings to share directly with specific consumers. Before you create your listing, prepare the data for your listing. See Preparing Data for a Listing.
Note
Only account administrators (i.e. users with the ACCOUNTADMIN role) or a role with the global CREATE DATA EXCHANGE LISTING privilege can complete the steps in this section.
Create a Free Private Listing¶
To create a free private listing, do the following:
Sign into Snowsight.
In the left navigation bar, select Data » Provider Studio.
Select + Listing. The Create Listing window opens.
Enter a name for your listing.
In the Who can discover the listing section, select Only specified consumers to privately share the listing with specific accounts.
In the How will consumers access the data product? section, select Free to offer a listing that is freely available to consumers.
Select Next.
Click + Select to select the objects to be in the listing.
If you select one or more database objects, Snowflake creates a secure share with those objects. You can choose to change the name of the secure share.
If you select an existing secure share, the name of the share that you selected appears.
Enter a description for your listing.
(Optional) If you have multiple provider profiles, select which provider profile to publish this listing as.
In the Add consumer accounts section, add the account identifiers for the consumers that you want to share the listing with.
If you add a consumer account in a region that is not your local region, Snowflake enables auto-fulfillment to allow data replication to the remote region. Complete the following additional steps:
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.
If you don’t have a default warehouse set, select a warehouse to use for auto-fulfillment.
Select Publish to publish the listing to the selected consumers, or click Save Draft to save it as a draft.
Note
Data is only replicated to the remote region after the consumer gets your listing. See Configuring Cross-Cloud Auto-fulfillment.
Create a Paid Private Listing¶
Creating a paid private listing involves the following steps:
Create a listing (this step).
Configure the listing. See Configure a Listing.
Submit the listing for approval and publishing. See Publishing a Listing.
To create a paid private listing, do the following:
Sign into Snowsight.
In the left navigation bar, select Data » Provider Studio.
Select + Listing. The Create Listing window opens.
Enter a name for your listing.
In the Who can discover the listing section, select Only specified consumers to share the listing privately with specific accounts.
In the How will consumers access the data product? section, select Paid to charge for the listing.
Select Next. A draft listing is created.
Before publishing your draft listing, you must configure additional required and optional capabilities. See Configure a Listing.
Create a Listing for the Snowflake Marketplace¶
Before you create your listing, prepare the data for your listing. See Preparing Data for a Listing.
Creating a listing for the Snowflake Marketplace involves the following steps:
Create a listing (this step)
Configure the listing. See Configure a Listing.
Submit the listing for approval and publishing. See Publishing a Listing.
To create a listing, do the following:
Sign into Snowsight.
In the left navigation bar, select Data » Provider Studio.
Select + Listing. The Create Listing window opens.
Enter a name for your listing.
In the Who can discover the listing section, select Anyone on the Marketplace to publish the listing on the Snowflake Marketplace.
In the How will consumers access the data product? section, select one of the following options:
Free to offer a listing that is freely available to consumers.
Paid to charge for a listing.
Personalized to offer customer-specific data products to consumers on the Snowflake Marketplace.
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¶
After you create a paid private listing or any listing for the Snowflake Marketplace, you must configure additional information for your listing before you can submit it for approval or publish it.
To configure a listing, do the following:
Sign into Snowsight.
In the left navigation bar, select Data » Provider Studio.
Select the Listings tab, then select the draft listing you want to configure.
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 Capabilities 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 Free Private Listing¶
To share your free private listing with the selected 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:
Sign into Snowsight.
In the left navigation bar, select Data » Provider Studio.
Select the Listings tab, then select the draft listing you want to publish.
Select Publish.
After you publish the listing, the listing is available for the selected consumers to access under 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 Paid Private Listing¶
To share your paid private listing with the selected 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:
Sign into Snowsight.
In the left navigation bar, select Data » Provider Studio.
Select the Listings tab, then select the draft listing you want to publish.
Select Publish.
After you publish the listing, the listing is available for the selected consumers to access under 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 Marketplace Listing¶
Every listing in the Snowflake Marketplace must go through the review and approval process. When a listing is approved, it can be published in the Snowflake Marketplace. If a listing is rejected, you can 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:
Sign into Snowsight.
In the left navigation bar, select Data » Provider Studio.
Select the Listings tab, then select the draft listing you want to submit for approval.
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.
If you submit a personalized listing for approval, Snowflake automatically publishes it to the Snowflake Marketplace. Other listings must be manually published the first time. To prevent your listing from being automatically published, see Deactivate Automatic Publishing.
Publish Your Listing¶
After a listing is approved, publish it on the Snowflake Marketplace:
Sign into Snowsight.
In the left navigation bar, select Data » Provider Studio.
Select the Listings tab, then select the approved listing you want to publish.
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 stop 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 Marketplace regions, but 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 allow you to provide consumers with 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:
Sign into Snowsight.
In the left navigation bar, select Data » Provider Studio.
Select the Listings tab, then select the approved listing for which you want to deactivate automatic publishing.
On the listing details page, select Settings.
In the Publishing section of the Listing Settings, select Edit Publishing.
In the Publish Settings dialog, select Manual.
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¶
Preview Feature — On Request
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:
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.
Create a private listing for the consumer. See Creating a Private Listing. Save the listing as a draft.
After the VPS consumer contacts you, update the listing to add the organization account(s) requested by the VPS consumer.
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, see Allow Providers to Share Private Listings into Your VPS.