Skip to main content
doc0blade47/dubdocumentation home
Sign in

Troubleshooting and FAQ

Last updated Oct 12, 2026

Overview

This guide helps you diagnose and resolve common issues you might encounter while using the application, including domain verification errors, failed partner payouts, tracking installation problems, and login or authorization challenges.

Use the sections below to find step-by-step troubleshooting instructions for each scenario.


Domain Verification Errors

Understanding Domain Verification Issues

When adding a custom domain to your workspace, you may occasionally run into verification issues due to incorrect DNS records, conflicts, or missing configurations.

Common Domain Errors and Their Meanings

Status / Error CodeDescriptionResolution Steps
Domain Not FoundThe domain has not been added to your project or DNS configuration properly.Check that you entered the correct domain name and that it points to your project.
Conflicting DNS RecordsExisting DNS records (such as an old A or CNAME record) are conflicting with the required configuration.Remove the conflicting records from your DNS provider, then set the recommended A or CNAME record.
Invalid ConfigurationThe domain's DNS records do not match the expected values.Verify your DNS provider settings against the required A, CNAME, or TXT verification values provided in your dashboard.
Unknown ErrorAn unexpected error occurred while communicating with the domain registrar or DNS management service.Wait a few minutes and try verifying again. If the issue persists, contact support.

Warning

If a domain remains invalid for more than 14 or 28 days, reminder emails will be sent to workspace owners. If a domain remains unverified for more than 30 days and has no active link clicks, it may be automatically deleted from the database.


Failed Payouts

Understanding Payout Failures

Partner payouts can occasionally fail due to issues with payment methods, authentication requirements, or insufficient billing details. When a partner payout fails, the affected payouts are automatically reverted back to a Pending status, and you will receive a notification email detailing the failure reason. If applicable, a payment failure fee may be charged to your card to cover processing costs.

Resolving Payout Failures

  1. Open your workspace settings and navigate to your billing or payment methods page to update your card or direct debit details.
  2. Go to your program's Payouts tab.
  3. Review the pending payouts and click Retry payout or Confirm all payouts once your payment details have been updated.

Tip

You can press the C key as a keyboard shortcut while viewing the payouts page to quickly open the confirmation sheet for pending payouts.


Tracking Discrepancies and Installation Issues

Understanding Tracking Installation Errors

If your analytics or conversion tracking script is not working correctly, you can verify your installation directly from your workspace settings. When you use the Verify installation tool in your tracking settings, you may encounter specific error codes that explain why the script cannot be validated.

Troubleshooting Installation Error Codes

  • Script is not installed (not_installed): The tracking script could not be found on the specified hostname. Ensure the script tag is added to your website's HTML header.
  • Script missing attributes (missing_attributes): The conversion tracking script is missing required attributes, such as a publishable key or SDK name.
  • Script is missing the referral link domain (missing_refer_domain): The tracking script needs to specify the correct referral link domain attribute.
  • Duplicate script (duplicate): More than one tracking script tag was detected on the page. Remove all but one valid script tag.
  • Malformed script (malformed): The script tag is improperly formatted or missing required source attributes.
  • We couldn’t reach this hostname (unreachable): The system was unable to establish a connection to your hostname. Check that your website is live and publicly accessible.
  • Wildcard hostnames can’t be verified (unsupported): Wildcard hostnames (starting with *.) cannot be automatically verified. Please select a specific subdomain or apex domain.

Important

Make sure your tracking script includes your correct publishable key and matches your active website domain.


Login and Authorization Issues

Understanding Access and Authorization Challenges

If you or your partners encounter issues accessing the application or partner portal, review the common error messages and resolution steps outlined below to restore access.

Authentication Error Reference

Error Code / MessageMeaningResolution
UnauthorizedYou are not logged in or your session has expired.Log in to your account at the appropriate portal URL to continue.
Partner profile not foundYour partner account does not exist or was not found.Complete the partner onboarding flow to create your profile.
Invalid or expired stateThe security state token for authentication or connection has expired.Restart the login or connection process from the beginning.
PayPal email address is not verifiedYour connected PayPal account has an unverified email address.Log in to PayPal, verify your email address, and try reconnecting.
The PayPal account you're trying to connect is already in useThe PayPal account is linked to another partner profile.Use a different PayPal account that is not currently tied to another partner.

Tip

If you experience persistent session issues, try clearing your browser cookies and cache, or log in using an incognito window.

Was this page helpful?