Oracle Cloud Infrastructure Documentation

Marketplace Publisher FAQ

Find answers to frequently asked questions related to OCI Marketplace Publisher.

Account Setup, Registration, Billing, and Regions

IAM, Authorization, Validation, and Limits

Listing Lifecycle, Revisions, Packages, and Approvals

Reports, OPN, OCMA, and Publisher Profile

Troubleshooting and Support

Account Setup, Registration, Billing, and Regions

Use these FAQs for account setup, publisher registration, billing setup, and region considerations.

Why do I need to upgrade to PAYGO to register as an Oracle Marketplace publisher if my Free Tier tenancy isn't in us-ashburn-1?

Publisher registration is available only in us-ashburn-1. Free Tier tenancies outside that region can't add or switch to us-ashburn-1, so registration is blocked.

To proceed, upgrade your tenancy to Paid (Pay As You Go), then subscribe to us-ashburn-1.

You're only charged if you use billable services.

For more information, see Managing Account Upgrades and Payment Method.

Why isn't us-ashburn-1 visible after upgrading from Free Tier to a UCM PAYGO subscription?

After upgrading to PAYGO, verify the following:

  1. Confirm the upgrade is complete:

    In the Console, go to Billing & Cost Management, Upgrade and Manage Payment. Ensure your plan now shows Paid (for example, Pay As You Go or active UCM), not Free Tier trial.

  2. Use a tenancy administrator account:

    Only tenancy admins can subscribe to regions.

  3. Subscribe to us-ashburn-1.
    1. Open the Region menu.
    2. Select Manage Regions.
    3. Find us-ashburn-1.
    4. Select Subscribe.
    5. Wait a few minutes for the region status to become active.
    6. Refresh the Console, or sign out and sign back in.
  4. If us-ashburn-1 still isn't listed:
    1. Check tenancy realm or order constraints:
    2. Some realms/subscriptions don't include every commercial region.
    3. Open an Oracle Support/Billing service request and include:

      Tenancy OCID, cloud account email, Manage Regions screenshot, upgrade timestamp, and current plan type.

  5. If us-ashburn-1 is listed but still not visible in the region picker:
    1. Wait for 10–15 minutes.
    2. Clear your browser cache.
    3. Sign out and sign back in.

For more information, see Managing Account Upgrades and Payment Method, Managing Regions, Subscribing to an Infrastructure Region.

Why was my credit card or payment information denied during OCI account creation?

If your payment information is denied during signup, try these steps before opening a ticket:

  1. Reenter your credit card details.
  2. Disable VPNs and ad blockers.
  3. Retry in an incognito/private browser window.

If the issue continues, contact Oracle support and include the timestamp, error screenshot, and cloud account email.

Support links:

Why does partner registration fail when I try to register with my OPN number?

Registration can fail if a Marketplace Publisher account already exists for that OPN number.

Contact your tenancy administrator to verify whether the publisher account already exists and request access.

How can I upgrade my tenancy subscription from Free Tier to UCM PAYGO?

To upgrade an OCI tenancy from Free Tier to UCM Pay As You Go:

  1. Sign in to the Console as the tenancy administrator.
  2. Go to Billing & Cost Management, Upgrade and Manage Payment.
  3. Review the plan details, add or update payment information if needed, accept the terms, and select Upgrade your account.
  4. Complete tax details if prompted, then confirm the upgrade.
  5. Wait for the confirmation email.
    The process can take 1–2 days.
  6. Verify under Subscription Information that the Plan Type is Pay As You Go.

If you need corporate/UCM billing setup instead of individual PAYGO, choose Request a sales call from the same page.

How can I upgrade my tenancy subscription from SaaS limit template to UCM PAYGO?

To move from a SaaS limit template to UCM PAYGO (CloudCM), request Oracle-side subscription provisioning and tenancy remapping, and then verify billing and support status.

To upgrade your tenancy subscription, follow these steps:
  1. Contact Oracle Sales or your account team and request an OCI Universal Credits (UCM) PAYGO or CloudCM subscription tied to your existing SaaS customer account.
  2. Provide tenancy details, including tenancy name or OCID, home region, admin email, and billing or legal entity information.
  3. Ask Oracle to link or remap the existing tenancy to the new UCM PAYGO subscription.
  4. After Oracle provisions it, go to Billing & Cost Management, and then select Subscriptions to verify that the plan or subscription shows paid UCM or PAYGO status.
  5. In Support Center, verify that a support CSI is present.

If your tenancy shows Upgrade and Manage Payment, that flow supports Free Tier to PAYGO upgrades, but SaaS-template conversions typically still require Oracle-side commercial setup.

What are the steps for a new publisher?

To get started as a new publisher, follow this onboarding path to complete prerequisites, set up access, create your first listing, and publish listings:

  1. Complete new partner prerequisites: Set up your Oracle account, join OPN, and finish onboarding. See New Partners.
  2. Review publisher requirements, roles, and readiness expectations. See Becoming an OCI Partner and Publisher.
  3. Learn the publishing workflow and listing/revision lifecycle in Console. See Console Publishing.
  4. Configure required IAM access so that your team can create, manage, and publish listings. See Required IAM Policy.
  5. Create your first listing based on your offer model by following these instructions:
  6. Submit your listing revision for review, address feedback, and publish when approved. See Publishing a Listing Revision.

IAM, Authorization, Validation, and Limits

Use these FAQs for access setup, authorization troubleshooting, validation issues, and service limits.

Why do I get "LimitExceeded - The following service limits were exceeded: listing-count. You can request a service limit increase from the Console's Limits, Quotas and Usage page or from the Help menu"?

You receive this error when the tenancy has reached the Marketplace Publisher listing limit. Request a service limit increase from the Console when the tenancy reaches the Marketplace Publisher listing limit.

To resolve the issue, request a service limit increase from the Console, follow these steps:

  1. Sign in to the tenancy.
  2. Go to Governance and Administration, Tenancy Management, and Limits, Quotas and Usage.
  3. Set the region to IAD / us-ashburn-1.
  4. In the filters, select the Marketplace Publisher service.
  5. Find the relevant limit, Listing Count / listing-count or Artifact Count / artifact-count.
  6. Select Request limit increase, or use Help and then Request a limit increase.
  7. Add the requested item with Service as Marketplace Publisher, Limit name as listing-count, Region as us-ashburn-1, Requested value as required count, and Reason as short business justification.
  8. Submit the request and track it from the limit increase request page.
Note

The current FAQ answer says this error is caused by an expired Free Tier subscription. That may be a separate issue and shouldn't be the primary answer for listing-count limit exceeded.

Why do I get "authorization failed" errors in Marketplace Publisher?

"Authorization failed" errors occur when one of the following is misconfigured:

  • IAM policy permissions
  • Compartment scope
  • Selected region

Use this checklist to troubleshoot the error and confirm that:

  1. You're using us-ashburn-1 (Marketplace Publisher service region).
  2. You have access to the target compartment.
  3. Your group has required Marketplace Publisher permissions, starting with marketplace-publisher-family.
  4. You're operating in the same compartment where the policy is granted.
  5. If the issue persists, collect the following information and contact support:
    • opc-request-id
    • Timestamp
    • User OCID or email
    • Tenancy OCID
    • Target compartment
    • Region used when the error occurred

For more information, see Required IAM Policy, New Partners.

Why does artifact validation fail when the image isn't available because of missing or incorrect IAM policies?

Artifact validation requires Marketplace to access and verify the referenced image. If IAM policies are missing, incorrect, or scoped to the wrong compartment or tenancy, Marketplace can't read the image (or related resources), so the image is treated as unavailable and validation fails.

Before rerunning validation, confirm that:

  1. Required IAM policies grant Marketplace read/inspect access to image artifacts.
  2. Policy scope matches the correct compartment or tenancy.
  3. The correct dynamic group or service principal is configured.
  4. The region and image OCID/reference are accurate.
  5. The image is shared or replicated where required.
  6. After fixing access, rerun artifact validation.

For more information, see Required IAM Policy, New Partners.

How can I increase the limit count for Marketplace Publisher resources?

Use the OCI limit-increase workflow to request higher Marketplace Publisher limits.

  1. Sign in to the Console with an account that can submit limit requests.
  2. Open Help and select Request a limit increase.

    You can also start from Limits, Quotas and Usage.

  3. In the request, add a requested item:
    • Service: Marketplace Publisher
    • Limit name: Select the Marketplace Publisher limit shown in your tenancy (for example, listing-count; use artifact-count only if it appears in your limit list)
    • Region: us-ashburn-1 (IAD), if that is where you publish
    • Requested value: Your needed count
    • Reason: Brief business justification
  4. Submit the request and track status from the limit-increase request page.

For more information, see Creating a Limit Increase Request and Marketplace Publisher FAQ (Why do I get "LimitExceeded - The following service limits were exceeded: listing-count. You can request a service limit increase from the Console's Limits, Quotas and Usage page or from the Help menu"?)

Listing Lifecycle, Revisions, Packages, and Approvals

Use these FAQs for listing creation, lifecycle stages, revision handling, package publishing, and approvals.

What is the SLA for approving listings on Marketplace?

OCI Marketplace approval timelines vary by listing type and can be extended by holidays or freeze periods.

OCI Marketplace approval timelines are:

Listing type Approval timeline
Paid listings 15 days
Free/BYOL listings 5 working days
OCI Lead Generation listings 5 working days

Approval timelines can be extended by US holidays and quarter-end or year-end freeze periods.

Why is my publisher listing not approved yet?

Approval can be delayed when review is still in progress or when required listing details are incomplete.

Marketplace product owners must also review the listing before it can be approved.

The following is a list of the possible reasons:

  • The listing is still within the normal review timeline.
  • Required metadata is incomplete.
  • Required artifacts are missing or invalid.
  • Documentation is incomplete.
  • The OCI Marketplace Agreement (OCMA) isn't active.

Approval can proceed only after product-owner review is complete and all required agreements and listing materials are in place.

When are listings made available in higher realms, such as OC2 and above?

Listings are rolled out to higher realms according to a defined SLA after publication. The target SLA is one month from the listing's publish date.

When do I create a service listing?

Use a service listing when offering OCI professional services rather than deployable application packages.

In Oracle Marketplace, a Service Listing means a listing for professional services (not a deployable software artifact), such as consulting, implementation, integration, training, or managed services related to Oracle Cloud.

A Service Listing is mainly used to describe your service offering, capture interest and leads, and help customers find you by using service-type filters.

For more information, see Managing Listings and Creating a Service Listing.

How do I unpublish packages that were already published after cloning a listing?

After cloning a listing, follow these steps to unpublish individual packages:

  1. Clone the listing.
  2. Add any additional packages you need.
  3. Publish the listing.
  4. Open the published listing.
  5. Go to the Packages tab.
  6. Find the package you want to remove.
  7. Open the three-dot menu for that package row.
  8. Select Unpublish.

Why do I get the error, "You can't create a new listing revision if there's already a listing revision in New status"?

This error appears when an existing listing revision is still in New status. Only one New revision is allowed at a time.

To fix it, do one of the following:

  • Submit the current New revision for approval.
  • Delete the revision in New status.

After that, create the new listing revision.

Reports, OPN, OCI Marketplace Agreement (OCMA), and Publisher Profile

Use these FAQs for reporting requests and partner membership or agreement administration.

How do I get a legacy leads report?

Contact Marketplace Help to get a legacy leads report.

To request a legacy leads report, email the Marketplace Help alias at marketplace-help_us_grp@oracle.com. Use this suggested message and add any relevant information:

Hi Marketplace Help Team,
Reports are currently unavailable in the portal. Could you please share the legacy leads report for our listing/account?
Thanks.

How do I renew my OPN membership or OCMA?

To keep Marketplace publishing active, ensure both your OPN membership and OCMA status stay current.

  1. Review your OPN renewal window: OPN renewals open 90 days before membership expiration (Keeping Your OPN Membership Active).
  2. In Oracle Partner Hub, go to Manage Membership, Check Subscription Status and Renew, OPN Membership, and Renew / Begin Application.
  3. Complete membership level/payment details and have an authorized signer accept current OPN terms.
  4. If renewal was missed, do one of the following:
    • Use Renew for memberships lapsed up to one year.
    • Use Apply for declined/non-payment or memberships lapsed more than one year.
  5. Check your publisher account for pending legal/agreement actions in Console publishing (Console Publishing).
  6. If you don't see the agreement task or need manual enablement, email ocmpartnerships_ww@oracle.com with your OPN Company ID and Tenancy OCID.

For more information, see Becoming an OCI Partner and Publisher and Oracle Marketplace Partner Home (OCMA context).

Troubleshooting and Support

Use these FAQs for troubleshooting diagnostics and support engagement workflows.

How do I get a .har file?

Capture browser network activity in a .har file and share it with support to troubleshoot Marketplace Publisher issues.

To capture browser network activity, follow these steps:

  1. Open the Console page where the issue occurs, such as the Marketplace Publisher homepage.
  2. Open browser Developer Tools by pressing F12 on Windows/Linux, or Option + Command + I on macOS Safari.
  3. Go to the Network tab.
  4. Filter to XHR or Fetch/XHR.
  5. Enable Preserve log.
  6. Clear existing network entries.
  7. Reproduce the issue once.
  8. For example, refresh the page or repeat the action that caused the error.
  9. Export the network log as a .har file.
  10. Send the .har file to the support team.