Create an organizational listing¶

1. Create an organizational listing.

   1. Sign in to Snowsight.

   2. Select Data Products » Provider Studio in the left-side navigation menu.

   3. Click + Listing » Internal Marketplace.

   4. Click + Data Product.

   5. In the + Data Product dialog, click + Select.

   6. Navigate to a data product such as a table, a view or other data product.

      Alternatively, search for and choose a data product to share.

   7. Select Done when complete.

   8. Select Save.

2. Specify who can access the listing (the target accounts, roles, and regions).

   1. Click + Access Control. The Access and discovery dialog displays.

   2. In the Grant access section, enter values for the following:

      Field	Description
      Who can access this data product?	Select one of: Entire organization Anyone in the organization can access the listing. Selected accounts and roles Only selected accounts and roles can access. No accounts or roles are pre-approved (Default) Data product will only be available by request.
      Accounts	If Select accounts and roles is selected, select one or more accounts. Click + Add another account to add second and subsequent accounts.
      Selected user roles	If Selected roles is selected, enter one or more roles to grant access.

   3. In the Allow discovery section, enter values for the following:

      Preview Feature — Open

      discovery is a preview feature and is available to all accounts.

      Field	Description
      Who else can discover the listing and request access?	Select one of: Entire organization (Default) Anyone in the organization can discover listing and request access. Selected accounts and roles Only selected accounts and roles can discover listing and request access. Not discoverable by users without access Only users with access can discover this listing.
      Accounts	If Select accounts and roles is selected, select one or more accounts. Click + Add another account to add second and subsequent accounts.
      Selected user roles	If Selected roles is selected, enter one or more roles to grant access.

   4. In the Request approval section, enter the email address of the request approver or link to the internal ticketing system.

3. Provide a title and Uniform Listing Locator (ULL).

   Changing a listings title is optional but recommended. See Uniform Listing Locator for more information.

   1. Select Untitled Listing.

   2. For Listing title, enter a descriptive title for your data product.

   3. Select Save or Cancel.

4. Complete the listing.

   Enter addition information about listing page to guide consumers, such as description, data dictionary, usage examples and more.

   Note that Support Contact is required

   1. Click Publish to make the listing available in the Internal Marketplace. If you exit without publishing, the listing is saved as a draft, ready for review or the addition of descriptive metadata.

Create an organizational listing from the share with the required attributes included in YAML (entered in $$ delimiters).

This part of the manifest yaml specifies the accounts that will be able to use the organizational listing:

organization_targets:
  access:

This example creates a listing using the required settings in the manifest YAML. It targets one role in one account in one region and includes support and approver contacts:

USE ROLE <organizational_listing_role>;

CREATE ORGANIZATION LISTING <organizational_listing_name>
SHARE <share_name> AS
$$
title: "My title"
description: "One region, all accounts"
organization_profile: "INTERNAL"
organization_targets:
  discovery:
  - account: "<account_name>"
    roles:
    - "<role>"

  access:
  - account: "<account_name>"
    roles:
    - "<role>"

support_contact: "support@somedomain.com"
approver_contact: "approver@somedomain.com"
locations:
  access_regions:
  - name: "PUBLIC.<snowflake_region>"
$$;

For additional examples see Set who can discover and access an organizational listing.