DNS Verification Won't Complete
The verification keeps failing
Solutions:
1. Wait longer
DNS changes take time (usually 30 minutes to 2 hours)
Don't click "Records verified" immediately after adding the record
Wait at least 30 minutes, then try again
2. Check the record type
Must be a CNAME record (not A, AAAA, or TXT)
Log back into your domain provider
Verify you selected CNAME when creating the record
3. Verify exact name and value
Copy and paste exactly from Markopolo (don't type manually)
Check for extra spaces at start or end
Values are case-sensitive
Even one wrong character will cause failure
4. Look for duplicate domain names
Some domain providers automatically add your domain to the end of the name. Check if you see:
❌ subdomain.example.com.example.com (duplicate - wrong)
✅ subdomain.example.com (correct)
If duplicated, edit the record and remove the extra domain part.
5. Check DNS propagation
Use a free DNS checker tool to see if your record is live:
Go to dnschecker.org
Enter your full record name
Select "CNAME" type
Look for green checkmarks
If the record doesn't appear, it hasn't been propagated yet - wait longer and check again.
No Events Appearing After Setup
I added the code, but I see no events
Step-by-step fixes:
1. Verify DNS is verified
Go back to the Website tab
Make sure the status shows "Connected" or that DNS is complete
If DNS isn't verified, complete that first
2. Check code placement
Web: Code should be in the
<head>section of your HTMLMake sure the code is on the pages you're testing
Verify the code wasn't accidentally deleted
3. Clear your cache
Clear the browser cache completely
Do a hard refresh:
Ctrl + F5(Windows) orCmd + Shift + R(Mac)Try in a private/incognito window
4. Look for errors
Press
F12to open developer toolsClick the "Console" tab
Look for red error messages
Take a screenshot if you see errors and contact support
5. Test from different places
Try a different browser
Test from your phone
Try from outside your office network
This helps identify if something is blocking the tracking
6. Give it time
Perform a test action (click something, view a page)
Wait 1-2 minutes
Refresh the Markopolo page
Events can take a minute or two to appear
7. Verify the code is loading
Press
F12for developer toolsClick the "Network" tab
Refresh your page
Look for a request to your MarkTag hostname
If you don't see it, the code isn't running
Events Stopped Working
It was working before, but stopped
What to check:
1. Code still there?
Did you update your website recently?
Check if the tracking code is still in your HTML
Website updates sometimes remove custom code
2. DNS record still active?
Log in to your domain provider
Check that the CNAME record still exists
Make sure no one deleted it accidentally
3. Recent changes?
New website deployment?
Theme or template update?
Changed hosting providers?
Any of these can remove the tracking code
What to do:
Add the code back if it's missing
Re-verify DNS if the record was deleted
Check with your development team about recent changes
Domain Registration Errors
"Invalid domain format" error
Fix it:
Remove
http://,https://, andwwwUse only:
example.comorshop.example.comNo trailing slashes or paths
No spaces or special characters
"Domain already registered"
What this means: Someone already set up tracking for this domain.
What to do:
Check the Website tab - is the domain already there?
If you need to reconnect, delete the old setup first
Contact support if you don't see it but can't register
Mobile App Issues
React Native is not tracking
Check:
Run
npm installoryarn installafter adding the packageRestart your development server
Rebuild your app completely
Check for errors in the React Native debugger
Verify the MarkTag ID is correct in your initialization code
Flutter not tracking
Check:
Run
flutter pub getafter adding the dependencyRestart your Flutter app completely
Check for errors in the Flutter console
Rebuild the app (not just hot reload)
Verify initialization code runs before tracking events
Unity not tracking
Check:
Verify the MarkTag SDK is imported into your Unity project
Check initialization script runs when the scene loads
Test in Unity editor first
Check the Unity console for error messages
Rebuild your game after adding the SDK
Still Not Working?
What do error messages mean
"Connection timeout"
Your internet connection may be unstable
Wait a minute and try again
"DNS record not found"
The CNAME record isn't visible yet
Wait longer for DNS propagation
Double-check you saved the record in your domain provider
"Authorization failed."
DNS verification didn't complete
Make sure the CNAME record is added correctly
Try verification again
Get Help from Support
When to contact us
Contact support if:
DNS verification fails after 48 hours
You've tried all the troubleshooting steps
Events were working, but stopped with no changes
You see error messages you don't understand
The tracking code is correc,t but no events after 24 hours
What to include
When you contact support, send:
Required:
Your domain name
Platform you're using (Web, React Native, Flutter, or Unity)
What step you're stuck on
Very helpful:
Screenshots of any error messages
Screenshot of your DNS record in your domain provider
Results from dnschecker.org (screenshot)
Screenshot of browser console (F12 → Console tab) if web
What you've already tried from this guide
For DNS issues:
Your domain provider name (GoDaddy, Cloudflare, etc.)
Screenshot showing the CNAME record in your DNS settings
How long ago did you added the record
Keep your tracking healthy
During setup:
Don't close the browser while setting up
Save DNS records before clicking verify
Test in a development environment first, if possible
After setup:
Write down where you added the tracking code
Check events weekly to catch issues early
Tell your development team about the tracking code before website updates
Set a monthly reminder to verify events are flowing
Before website updates:
Note where the tracking code is
Make sure developers know not to remove it
Test tracking after the update goes live