Creating a Listing

Based on your publisher permissions, you can create app listings, Oracle Cloud Infrastructure application listings, or service listings.

• An app listing is for products that will integrate with Oracle Cloud offerings, such as Oracle Sales Cloud or Oracle Marketing Cloud. Apps provide enhanced functions or customizations for an existing Oracle Cloud implementation.

• An OCI Application Listing is for products that will integrate with Oracle Cloud Infrastructure applications, such as Oracle Cloud Infrastructure Compute. Apps provide enhanced functions or customizations for an existing Oracle Cloud Infrastructure implementation.

• A service listing is for professional services, such as consulting, training, integration, or implementation, related to Oracle Cloud offerings. For example, you might offer a service that helps companies transition their business to the cloud.

If you’re approved to publish only app listings or only service listings, then the appropriate form opens automatically when you click Create Listing. If you’re approved to publish app listings, Oracle Cloud Infrastructure application listings, and service listings, then the system prompts you to select which type of listing you want to create. If you don't see OCI Application Listing as an option while creating a listing, contact Oracle Support to enable this option for your account.

• App Name or Service Name — Enter a descriptive name for your listing. This should be the name of your application. Avoid using Oracle product names in the title. Your app name can contain a maximum of 80 characters.
• Headline — Enter a brief description that will show at the top of your listing. This should indicate the application’s purpose.
• Categories or Industry Focus — Make sure that you select the product/category that has integration with your listing. Your selection helps people to find your listing.
  Note
  
  If your listing does not have an Oracle SaaS integration but runs independently on OCI, you must select OCI as the product/category instead of the Oracle SaaS product.You can select multiple categories ensuring that your selections have integration with your listing. If your listing does not have an integration with any of the Oracle SaaS services, you SHOULD NOT select any of the SaaS product categories (even though your solution itself is in that category) for your Marketplace listing. In such cases, you must only select the OCI product categories. Oracle may choose to recategorize the application as part of the curation review process.
  Note
  
  If you are a healthcare partner, make sure you select Healthcare under the Oracle Healthcare Marketplace product.

  

• Select Pricing Model (only app listings) — Select one of the following options to specify whether your app is free, paid, or requires the user to use an existing license.
  • Free — There are no charges for use of your offering.
  • BYOL — The Oracle customer contracts with you directly for licensed use of the software. This option is available only for Oracle Cloud Infrastructure application listings.
  • Paid — The Oracle customer purchases use of your offering with the usage computed on a hourly or monthly basis. If you select this option, you must specify the pricing unit in a later step.
• Keywords (only app listings) — Keywords identify this listing in Oracle Cloud Marketplace search. Separate each keyword by a comma.
• Products (only service listings) — Select only those products with which your service has an integration. For example, select Oracle CX Cloud only if your service has an integration with Oracle CX Cloud Suite.

• You can complete the other sections in any order. For example, you can upload the icon, add information to one or more sections, and then upload a banner.

• Only one section can be active for editing at a time. You must close a section (either by saving or canceling your changes) before you can edit another section. Otherwise, the Upload, Edit, and Add options aren’t active.

• You don’t have to complete the form all at once. You can enter some information, preview the listing, and then return to edit or add details. You can continue to preview and revise your listing until it’s exactly right.

You can include the following information for your listing:

• App Listing tab (only app listings):

  • Banner — The banner displays at the top of the details page and spreads across the width of the page.

  • Icon — The icon displays on the listing pages for your app. The listing icon is the icon for the application that you create.

  • Keywords — Add market-specific terms, synonyms, and other tags for your app. Oracle Cloud Marketplace includes this information when looking for apps that match the user-defined search string. The right words increase the chances that users find your app. To specify more than one keyword, separate each keyword with a comma.

  • Configure URLs:

    • Launch Demo — Your app listing can include a link to a demonstration of your app hosted on an external site. For example, you can add a link to a video walk-through of your app, an interactive website, a webcast recording, or a prototype of your app.

    • Self-Paced Training — Your app listing can include a link to a self-paced training. For example, you can add a link to a video, an interactive website, a webcast recording, or other details such as documentation.

  • Description — Add a description of your app to help users understand what your app or service does. You can add a short description and a long description. The short description must be a single paragraph of at most 320 characters, which provides a high-level introduction to your application and highlights the value of any integration with the Oracle Cloud services. The long description must be a detailed description about your application. The character limit for long description for a listing is 12000.

  • Pricing — If you had selected Paid as the pricing model in the Pricing Information selection earlier, then you must specify the price and its unit. Enter the price in USD. You can enter a price to 4 units of precision to the right of the decimal, for example $999.9999. You must also select one of the following as the unit for the price:
    • OCPU per hour: This is the hourly price multiplied by the number of OCPUs used for your offering per hour.
    • Instance per hour: This is a fixed price for each instance per hour.

    For a paid listing, you can't update the price and pricing unit fields of a listing that's already published. You have to create a separate listing if you need to modify the price of a published listing.

  • Usage Information — Add information or instructions that will help customers to use the application after launching the instance. You can also include useful links. For example, you can add links to additional setup instructions or frequently asked questions. The character limit for Usage Information for a listing is 12000.
  • Markets — Select one or more markets where you want your listing to be available for customers to purchase. When you create a paid Oracle Cloud Infrastructure application listing, customers can deploy the listing on Oracle Cloud Infrastructure data centers in all regions they can access. However, your customers can buy your paid listings only in the markets that you select. For example, if you select the US commercial market, only customers based in US can purchase your listing.

    There are two types of markets: commercial and government. You'll see commercial and government market options in the Market section for your Oracle Cloud Infrastructure application listings.

    While creating Free/BYOL (or Oracle Owned Paid) listing, you'll see the Worldwide Commercial Markets check box selected by default in the Markets section. If you want to publish Free and BYOL listings to government markets only, clear the Worldwide Commercial Markets check box, and select the required government markets. So, your listing will be published only to the selected government markets.

    Note: If a package is attached, you must select at least one market in order to submit your listing. Listings in governmental markets are subject to additional approval from their administrators. Oracle makes no guarantees regarding publication or availability within these markets. Ensure that you have set up the required policies in your Oracle Cloud Infrastructure tenancy to allow Oracle Cloud Marketplace to access the resources in your tenancy. See Creating a Policy for an OCI Tenancy. For information about the policies to publish your listings to government markets, see Policy for Government.

  • Screenshots and Videos — Uploading videos and screenshots is a great way to enhance your listing. For example, you can use this feature to walk the Oracle Cloud Marketplace user through the app you provide. Oracle Cloud Marketplace displays thumbnails for your videos and screenshots on the right side of your app listing page. Users can click a thumbnail to enlarge the image view in another window and then click to cycle through your set of videos and screenshots.

    Promotional videos that are hosted on YouTube or Vimeo can be embedded directly in the screenshot list and media viewer. Videos or customer demonstrations hosted on other sites can be linked either by using the Launch Demo field under Configure URLs in the listing header, or from the Related Documents section of the listing.

  • Version Details — Enter application version details and a summary of what's new in this release. The details must include the specific application or extension that is made available from the Oracle Cloud Marketplace. Use the version description to highlight any version specific information such as what's new in this release.

  • Application Properties — The Application properties section appears only for some categories and the options available are based on your selections in the Categories field in the header section. If you see the Application properties section, you can select one or more custom filters for your listing, filtering by sub-products or by sub-categories such as business-to-business (B2B) and business-to-consumer (B2C). The filters you select appear in the Filter by list in Oracle Cloud Marketplace after the user selects a specific product.

    Note
    
    If you are a healthcare partner, you must select the corresponding products that you selected earlier, under the new application property called Oracle Healthcare Marketplace. For example, if you chose Clinical & Financial Ops and Consumer Experience as your products when you created the listing, make sure you check those products here.

    

  • Related Documents — Add related documents such as case studies, customization guides, data sheets, press releases, user guides, webinars, or white papers. If you have documents you want to be available only internally to Oracle (for example, for the Oracle Sales team), select For Oracle Internal View. These documents will display in the Marketplace listing details page only if the user is logged in with an @oracle.com email address.

  • Support — Add links and contact information for users to get support for your app. You can add multiple links and contacts if required.

  • System Requirements — List any Oracle Cloud and third party system, version, or license requirements and dependencies, including relevant minimum version numbers, or required options.

  • Languages — Select the languages supported by your app. By default, English is selected. You can select one or more languages. At least one language must be selected.

  • Regions — Select the regions where you want to make your application available. If you don’t choose specific regions, then your application will be available in all regions..

  • Recommended Service Providers — If you have any recommended service such as consulting, integration, or training for your application, you can select it in this section.

• Get App tab (only app listings):

  • Download Information — If you don’t create an install package for your app, you can choose how Marketplace customers get your app. You can contact them directly, provide custom download instructions, or redirect the user to your company website (or any URL) for more information.

• Service Listing tab (only service listings):

  • Banner — The banner displays at the top of the details page and spreads across the width of the page. Your banner must be 1026 pixels (width) by 200 pixels (height), a maximum of 10 MB, and must be a BMP, GIF, JPEG (JPG), or PNG file.

  • Icon — The icon displays on the listing pages for your service. Your icon must be 130 pixels by 130 pixels, a maximum of 5 MB, and must be a BMP, GIF, JPEG (JPG), or PNG file.

  • Keywords — Add market-specific terms, synonyms, and other tags for your service. Oracle Cloud Marketplace includes this information when looking for services that match the user-defined search string. The right words increase the chances that users find your app or service.

  • Description — Add a description of your service to help users understand what your app or service does.

  • Number of Trained Professionals — Enter the number of experts you have for each associated product.

  • Customer Successes — Supply information about your success stories. Enter the name of the customer, upload a story about the success, and/or provide a link to the success story. You can also select one or more Oracle Cloud services for every customer success story.

  • Screenshots and Videos — Uploading videos and screenshots is a great way to enhance your listing. For example, you can use this feature to walk the Oracle Cloud Marketplace user through the app or service you provide. Oracle Cloud Marketplace displays thumbnails for your videos and screenshots on the right side of your service listing page. Users can click a thumbnail to enlarge the image view in another window and then click to cycle through your set of videos and screenshots.

  • Related Documents — Add related documents such as case studies, customization guides, data sheets, press releases, user guides, webinars, or white papers. If you have documents you want to be available only internally to Oracle (for example, for the Oracle Sales team), select For Oracle Internal View. These documents will display in the Marketplace listing details page only if the user is logged in with an @oracle.com email address.

  • Services — Add the service type filters to your listing, including a description of the service and a file with the details about your service. For example, if you are a consulting service, add that as your service type. The filters you select appear in the Filter by list in Oracle Cloud Marketplace includes a Service Type filter that can be used to find listings for a specific service type.

  • Geographic Focus —Enter information about which of your offices service each geographic region (your offices might not be located in that region).

  • Languages — Select the languages supported by your service.

• Contact Us tab (only service listings) — Include instructions for your customers. When users click Contact Us and submit their customer details, Oracle Cloud Marketplace will display your instructions. If you leave this field blank, then Oracle Cloud Marketplace will display the following message: “Thank you for your interest. The application provider has been informed about your request and will contact you soon.”

• App Install Package tab (only app listings) — For apps, you can also include an install package so customers can automatically install your app from the marketplace. See Building an Install Package .

• Additional Information tab — When you create an app or a service listing for Oracle Cloud Marketplace, you have the option to create a vanity URL for your listing. For app listings you can also submit documents that Oracle can use when reviewing and approving your app listing. See Adding a URL and Supporting Document.

• Vanity URL — Partner Portal automatically creates a URL for each listing you post to the Oracle Cloud Marketplace website. In addition, you can create a vanity URL for any of your listings. You can use a vanity URL to brand your app or service for marketing purposes.

  Vanity URLs usually consist of meaningful words or phrases instead of random letters and numbers. As a result, vanity URLs are easy to remember, easy to use, easy to share, shorter than traditional URLs, and more pleasing to the eye.

• Supporting Documents (only app listings) — When you submit your app listing and app to Oracle for approval, we conduct a complete review of your app. Our review may include a technical architecture review, a security review, and a demonstration of the app. You can include any type of document, such as technical integration documents, security documents, deployment guides, or use cases, that can help us evaluate and approve your app. Click Add to upload an existing document.

  You can also click Get Templates to download templates that you can use to create supporting documents to submit with your app. Each template provides guidelines about the type of information we look for when reviewing your app.

  Note that the documents you include in the Supporting Documents section are for use by Oracle only. If you want to include documents that Oracle Cloud Marketplace users can access from your listing page, then add the documents to the Related Documents section on the App Listing tab or the Service Listing tab. You can add documents such as case studies, data sheets, press releases, and user guides; and you can choose to upload or link to the documents. For service listings, you can also add success stories to the Customer Successes section.

variable "marketplace_source_images" {
  type = map(object({
    ocid = string
    is_pricing_associated = bool
    compatible_shapes = set(string)
  }))
  default = {
    main_mktpl_image = {
      ocid = "ocid1.image.oc1..<unique_id>"
      is_pricing_associated = true
      compatible_shapes = []
    }
  }
}

Where, the input variable marketplace_source_images of type map contains elements of the type object.

Note that the map key defined for each object can be anything as long as they are unique. In this example, the marketplace_source_images map contains a single default object keyed under, main_mktpl_image, an arbitrary name.

Each object element represents a marketplace image used by the Terraform stack and has the following three attributes:

• ocid: You must specify the OCID of the marketplace image that you have defined in your image listing. To identify the OCID of the marketplace image, view the image artifact details and note the value of the Published Image OCID field. See Viewing Artifact Details.
• is_pricing_associated: If the marketplace image is associated with a price, then set this value to true.
• compatible_shapes: Comma-separated list of the Oracle Cloud Infrastructure shapes that the Marketplace image is compatible with. See Compute Shapes.

...
- title: "Hidden Variables"
    visible: false
    variables:
      - ${tenancy_ocid}
      - ${region}
      - ${marketplace_source_images}
      ...

The following example contains an additional application catalog image object under the supporting_image key. Key names are not fixed. You can associate any value to a key name as long as the value is unique for every element in the marketplace_source_images input variable of the type map. Ensure that you provide the correct values to is_pricing_associated and compatible_shapes attributes so that Terraform can parse the definitions.

variable "marketplace_source_images" {
  type = map(object({
    ocid = string
    is_pricing_associated = bool
    compatible_shapes = set(string)
  }))
  default = {
    main_mktpl_image = {
      ocid = "ocid1.image.oc1..<unique_id>"
      is_pricing_associated = true
      compatible_shapes = []
    }
    supporting_image = {
      ocid = "ocid1.image.oc1..<unique_id>"
      is_pricing_associated = false
      compatible_shapes = []
    }
  }
}

You'll see the market options for paid, free, and BYOL Oracle Cloud Infrastructure application listings.