Troubleshooting Guide

Common Implementation Issues

Player Not Loading

1. Check Script Installation

   <!-- Verify correct script URL and API key -->
   <script id="do-audio-tour-player" 
       type="module" 
       src="https://player.doaudiotours.com/do-audio-tour-player-v2.js?key=[YOUR_API_KEY]">
   </script>
   

Common Solutions:

• Verify script URL matches exactly as shown above
• Check for JavaScript console errors
• Ensure script loads in network tab
• Verify no Content Security Policy blocks

Dynamic Values Not Working

1. Check Variable Integration

   <!-- Example WordPress implementation -->
   <do-audio-tour-player-v2
       listingId="<?php echo esc_attr(get_post_meta(get_the_ID(), 'mls_number', true)); ?>">
   </do-audio-tour-player-v2>
   

Common Solutions:

• Debug dynamic value output
• Verify MLS number format
• Check template variable scope
• Test with hardcoded value first

Test With Known Working Example

Use this exact configuration to verify your setup:

<do-audio-tour-player-v2 
    listingId="2405225" 
    pageTranslate="true"
    playerTheme="light"
    defaultLanguage="en-US">
</do-audio-tour-player-v2>

<script id="do-audio-tour-player" 
    type="module" 
    src="https://player.doaudiotours.com/do-audio-tour-player-v2.js?key=eyJpdiI6IjA2MHBrUkNJRjhKZmpKV0RJc3ZIbnc9PSIsInZhbHVlIjoiR0xtdnRCbSt3MWtudldlVFRJREdhRUsvZEw0UlA2NFpaT0loYWdtcWo1VnZUd2EvaHV4YlVDd1ViVmwxckNCL1RBMllXb1p2V25BUDRwamlrRHpvYkR3T1BhVHZjQ2djeDJXRXZKVHBrZ25Zb3VuWjl3aDdNc3lsRUtGRUd6UnhEOUdyMXF3UjBJQUkreTNicnRFblJ3PT0iLCJtYWMiOiJiNzhhOTE1YTgwYmY1YjZhY2ZlZjNkYzZkYTZlNjdlYTQ2NzEyMGQ2OWQwZDQwMTNlOTAyYzQyYjQ3NmVjYWU1IiwidGFnIjoiIn0=">
</script>

If this example works but your implementation doesn't:

1. Compare script URLs character by character
2. Verify your API key format
3. Check your listing ID format
4. Inspect network requests for any differences

Common Error Messages

Error Message	Solution
"Invalid API key"	Verify key matches example exactly
"Failed to load resource"	Check script URL matches example
"listingId required"	Check dynamic value passing
"Listing not found"	Verify listing ID format

Integration-Specific Issues

WordPress

• Verify script loads after jQuery
• Check theme compatibility
• Test in default theme

IDX Integration

• Verify listing data structure
• Check variable naming
• Test data flow

Still having issues? Check our Contact & Support page for help.