Create and publish a listing¶
This topic contains procedures for creating and publishing a listing privately or on the Snowflake Marketplace.
Prerequisites for listing creation¶
Agree to the Snowflake Provider and Consumer Terms. Acceptance of the Snowflake Provider and Consumer Terms is not required when creating free or paid off-platform private listings, but you must review and accept the Snowflake Customer-Controlled Data Sharing Functionality Terms.
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.
Prepare the data for your listing. See Prepare data for a listing.
To learn more about the requirements for becoming a provider, see Use listings as a provider.
Considerations for sharing listings to accounts in US government regions¶
Non-government providers who want to share listings with consumer accounts in US government regions must consider the following details:
The account in the US government region must enable data sharing and collaboration. See Prepare to access listings from accounts in U.S. government regions.
You must use Cross-Cloud Auto-Fulfillment, and your data product can only contain or reference objects supported for 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 (SSA) 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 Auto-fulfillment costs.
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 (or paid off-platform) private listing¶
Sign in to Snowsight.
In the navigation menu, select Data sharing » Provider Studio.
Select + Create Listing » Specified Consumers.
In the Edit listing title dialog, enter a name for your listing.
Select the Add data product button, then click + 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 that share appears.
In the Access type dropdown, select Free.
In the Who can access 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 isn’t 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:
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.
See Auto-fulfillment for listings for more details.
Enter a description for your listing.
In the Legal Terms section, select the legal terms that apply to your listing.
If you don’t see any legal terms, you must first accept the Snowflake Provider and Consumer Terms.
(Optional) In the Attributes section, add custom attributes to your listing. For more information, see Data product - attributes.
(Optional) Click in the Data dictionary section to add featured objects from the listing’s data dictionary. For more information, see Set up a data dictionary for your listing.
(Optional) Click in the Business needs section to add tags that describe the business needs that your data product addresses. For more information, see Business needs.
(Optional) Click in the Quick Start Examples section to add sample SQL queries or a notebook that demonstrate how to use the data product. For more information, see Attach a notebook to a Snowflake Marketplace listing.
Select Publish to publish the listing to the selected consumers. Snowflake saves your listing if you don’t publish it immediately.
Create a paid private listing¶
Sign in to Snowsight.
In the navigation menu, select Data sharing » Provider Studio.
Select + Create Listing » Specified Consumers.
In the Edit listing title dialog, enter a name for your listing.
Select the Add data product button, then click + 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 that share appears.
In the Access type dropdown, select Free.
In the Who can access 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 isn’t 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:
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.
For more information about auto-fulfillment, see Auto-fulfillment for listings.
Enter a description for your listing.
In the Legal Terms section, select the legal terms that apply to your listing.
If you don’t see any legal terms, you must first accept the Snowflake Provider and Consumer Terms.
(Optional) In the Attributes section, add custom attributes to your listing. For more information, see Data product - attributes.
(Optional) Click in the Data dictionary section to add featured objects from the listing’s data dictionary. For more information, see Set up a data dictionary for your listing.
(Optional) Click in the Business needs section to add tags that describe the business needs that your data product addresses. For more information, see Business needs.
(Optional) Click in the Quick Start Examples section to add sample SQL queries or a notebook that demonstrate how to use the data product. For more information, see Attach a notebook to a Snowflake Marketplace listing.
Click in the Pricing section to set up pricing information for your listing. For more information about pricing plans and offers, see Pricing plans and offers.
In the Pricing plans tab, select Create pricing plan.
In the Settings dialog, specify a display name for your pricing plan, then click Next.
In the Pricing details dialog, specify a pricing model. You can choose either Usage-based or Flat fee.
If you select Usage-based, specify the following details:
The usage-based access fee (monthly fee).
The cost per query and the number of included queries (optional).
The maximum monthly charge (optional).
If you select Flat fee, specify the flat fee amount and the billing frequency.
Click Next.
In the Summary dialog, review the pricing details, then click Done.
Navigate to the Offers tab.
In the Offers tab, select + Create offer.
In the Offer details dialog, specify details for the offer.
Select Standard offer
In the Purchase type dropdown, select Self-serve to allow consumers to see the price and purchase the listing directly, or select Sales-led to require consumers to contact you to purchase the listing.
Specify a name for the offer.
Select Next.
In the Billing and payments dialog, select the pricing plan to attach to this offer.
In the Select a pricing plan dropdown, select the pricing plan that you created earlier.
Select a contract type of either Limited-time or Recurring (Subscription).
Specify a contract duration.
In the Payment options dropdown, select whether to charge customers based on the pricing plan or to allow payment in installments.
If you select Accept installments, specify the number of installments and the frequency of the installments.
Specify the date of the first invoice or to invoice when the offer is accepted.
(Optional) Specify whether to require consumers to include a credit card on file to purchase the listing
Select Next.
In the Description dialog, enter information about the offer that users will see.
Specify an offer name to display to consumers.
Specify the price to display to consumers.
(Optional) Specify a tagline to display to consumers.
Specify the text for the button that consumers click to purchase the listing.
(Optional) Specify any value propositions for the offer.
Select Next.
Return to the Listing details tab. You will see that the offer you created is now attached to the listing.
Select Publish to publish the listing to the selected consumers.
If you exit without publishing, the listing is saved as a draft.
Create a usage-based trial¶
In a usage-based trial, you can offer a number of free queries that consumers can run against your data product. After all free queries have been used, the consumer must purchase the data product to run additional queries.
To add a trial to a listing, the listing must have a data product attached and you must have the ACCOUNTADMIN role or the OWNERSHIP privilege on the listing. To learn more about the privileges required to manage listings, see Prepare data for a listing.
Create a listing that includes a pricing plan and offer, as created in the previous example.
On the Listing details tab, click in the Trial (Optional) area, and select one of the following usage trial types:
Limited Usage (available for usage-based pricing plans only)
Limited Time
Limited Functionality
Limited Functionality & Time
If you selected Limited Usage, enter a value in the Number of Free Queries During Trial field.
If you selected Limited Time or Limited Functionality & Time, enter a value in the Length of Trial field.
Select Save.
Select Publish to publish the listing to the selected consumers.
If you exit without publishing, the listing is saved as a draft.
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.
Sign in to Snowsight.
In the navigation menu, select Data sharing » 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 Configure listings for information on each field. The specific properties available to edit depend on the type of listing that you create.
Publish 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 (or paid off-platform) 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.
Sign in to Snowsight.
In the navigation menu, select Data sharing » 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 from Private Sharing. See Access and install 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.
Sign in to Snowsight.
In the navigation menu, select Data sharing » 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.
Publish your listing¶
Sign in to Snowsight.
In the navigation menu, select Data sharing » 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 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 Auto-fulfillment for listings 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.
Sign in to Snowsight.
In the navigation menu, select Data sharing » 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 Setting window, 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.
Attach a notebook to a Snowflake Marketplace listing¶
Providers can add a notebook to a listing to show potential consumers how they can leverage and benefit from a data product. The listings can be available on the Snowflake Public Marketplace, Internal Marketplace, or as a private listing to a select set of consumers.
A provider can attach a notebook that was fully run with results to a listing. The results can include tabular outputs or visualization to describe the value of the data products within a listing. Providers can include both Python-based and SQL-based examples in the notebook and add clear Markdown explanations to guide consumers.
Note
Notebooks attached to a listing are view-only and can’t be cloned, downloaded, or interacted with by the consumer.
To attach a notebook to a listing, follow these steps:
Sign in to Snowsight.
In the navigation menu, select Projects » Notebooks.
In each cell of the notebook, select Run all or Run to generate results. Ensure that you run in each cell.
To verify that the notebook runs successfully, locate the green run-status indicator.
To end your Notebooks session, select the Active drop-down and select End session.
In the navigation menu, select Data sharing » Provider Studio. You can attach a notebook to all listing types.
Create a new listing or choose an existing listing.
Select + Add data product.
Choose + Select.
In the Quick Start Examples section, select Add Notebook.
Select the notebook to attach. You can use the search feature to find a specific notebook.
Select Save.
To publish the listing to the selected consumers, select Publish.
Note
To update the contents of the notebook after attaching it to a listing, you must remove the notebook from the listing and attach it again.
Remove a notebook from a listing¶
In the navigation menu, select Data sharing » Provider Studio.
In the Quick Start Examples section, select the notebook to remove.
Select Remove Notebook.
Note
If you lose ownership of the notebook, or if you delete it or remove it from your shared resources, a copy remains with the listing.
Limitations¶
Providers can only attach one notebook to a listing, and the provider must have OWNERSHIP privileges on the notebook.
Consumers can only view the notebook and its results in the listings.
Changes in the notebook aren’t automatically updated in the listing. To reflect the latest changes, you must remove the notebook and add it back again.