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 paid listings or listings on the Snowflake Marketplace.
If you want to charge for your data product, set up your account to provide paid listings.
Get access to a role with provider privileges.
See Becoming a provider of listings for details.
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:
The account in the US government region must enable data sharing and collaboration (preview).
You must use Cross-Cloud Auto-fulfillment, and your data product cannot contain objects unsupported by auto-fulfillment.
If you offer a listing to US government regions on the Snowflake Marketplace or directly to a consumer account in a US government region, the secure share area created to auto-fulfill the listing to that region incurs costs at the rate specific to that region. See the consumption table available from Snowflake Legal, the pricing guide and Managing Cross-Cloud Auto-fulfillment costs.
You do not get usage data about consumer accounts in US government regions from the views in the Data Sharing Usage schema in the shared SNOWFLAKE database.
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 in to 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 organization and account names 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 select 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 in to 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.
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.
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 in to 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 in to 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 in to 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 in to 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 in to 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 in to 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 in to 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.