Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

How to: Verify your Domain

Verifying a domain allows you to keep greater control of your organization when using Goodnotes Teams and the Goodnotes Admin Console.

See below for a step-by-step guide on how to verify your domain:

Prerequisites

  • You must have Organization Admin role permissions in the Admin Console

  • Access to modify your domain's DNS records

  • A domain that is not already verified by another organization

Video Walkthrough

 

Step-by Step Instructions

1. Add your domain

  1. Navigate to Identity provisioning → Domain management in the Admin Console
  2. Click the Add domain button
  3. Enter your domain address

System Check: The system will check if the domain is already verified. If the domain is unverified (even if it was previously added by another organization), it will be added to your list with the status "Pending." The first organization to successfully complete all verification steps claims exclusive ownership of the domain.

2. Get your verification code

  1. After entering your domain, you'll receive a unique verification code
  2. The code will be in this format: goodnotes-verification={UUID}
  3. Copy this verification code - you'll need to add it to your DNS settings

3. Add TXT record to DNS

To add the verification code to your DNS settings:

  1. Log into your domain provider's control panel
  2. Find the DNS or Domain settings section
  3. Add a new TXT record with these settings:
    • Record Type: TXT
    • Host/Name: Your domain (e.g., example.com) or @ symbol
    • Value/Data: Your verification code (e.g., goodnotes-verification=XXXXXXXXX)
    • TTL: Default value (usually 3600 or 1 hour)
  4. Save your changes

Note: DNS changes can take up to 72 hours to propagate across the internet, though this usually happens much faster. This may depend on your DNS provider.

4. Verify your domain

  1. Return to the Admin Console
  2. Click "Verify domain" to check the status
  3. The system will automatically check for verification hourly for the next 30 days

If your organization successfully verifies the domain, the record will be set to "Verified," and all unverified records held by other organizations will be automatically removed (they will receive an email notification). If another organization verifies the domain before you do, your unverified domain record will be automatically removed from your Admin Console, and you will receive an email notification.

Domain verification status

Your domain can have one of these status labels:

  • Pending: Initial status after adding domain
  • Verified: Domain successfully verified
  • Missing token: Verification code no longer found in DNS

After verification

Once your domain is verified, you can:

  • Select your Identity Provisioning method, whether OIDC or enable SAML SSO for your organization. 
  • Use auto-capture to automatically add new users with your domain to your organization when they sign-in to Goodnotes Teams
  • Manage user access and permissions

Maintaining verification

To maintain your domain verification:

  • Keep the TXT record in your DNS settings
  • If the TXT record is removed, you'll have 30 days to re-add it before the domain status changes to "Pending"

  • You'll receive email notifications if any action is needed

    If you need immediate assistance or encounter any issues during the verification process, contact Goodnotes support.