Eduxa University Search - Embed Integration Guide#
What is Eduxa University Search?#
Eduxa University Search is an embeddable widget that allows your website visitors to search and explore thousands of universities worldwide directly on your site. When students apply through your embedded search, they're automatically attributed to your agency.
Quick Start#
1. Get Your API Key#
Contact Eduxa to receive your unique agency API key. It will look like this:2. Copy Your Embed Code#
Replace YOUR_AGENCY_KEY with your actual API key:3. Add to Your Website#
Paste the code anywhere you want the search widget to appear. See platform-specific instructions below.
WordPress (Gutenberg Editor)#
2.
Click Add Block → Custom HTML
WordPress (Elementor)#
2.
Drag an HTML widget to your section
WordPress (Classic Editor)#
1.
Switch to Text tab (not Visual)
Shopify#
1.
Navigate to Online Store → Themes → Actions → Edit code
2.
Open the template file (e.g., page.study-abroad.liquid)
3.
Paste the embed code where you want it
Wix#
4.
Drag to position and publish
Static HTML / Custom Sites#
Add the code anywhere in your <body> tag:
Customization#
Styling the Container#
You can style the widget container with custom CSS:Responsive Adjustments#
The widget is responsive by default, but you can add custom breakpoints:
How Attribution Works#
Automatic Student Tracking#
When a visitor uses your embedded search widget:1.
✅ They browse universities on your site (embedded interface)
2.
✅ They click "Apply Now" on any university
3.
✅ They register on Eduxa (via form or social login)
4.
✅ They're automatically attributed to your agency - permanently
Key Benefits#
First-touch attribution: Once attributed, always attributed
No user action needed: Attribution happens automatically via secure cookies
Persistent tracking: Works even if the student returns days later from a different source
Social login support: Works with Google, Facebook, LinkedIn, and email registration
Attribution Scenarios#
| Scenario | Result |
|---|
| Student registers immediately after using your widget | ✅ Attributed to you |
| Student browses, closes browser, returns next day to register | ✅ Attributed to you |
| Student uses your widget, then finds Eduxa via Google, registers | ✅ Attributed to you |
| Student registers via Google/Facebook OAuth | ✅ Attributed to you |
| Student already registered before finding your widget | ❌ Not attributed (first-touch rule) |
Testing Your Integration#
Step-by-Step Test#
1.
Visit your page with the embedded widget
2.
Verify the search interface loads (should see university search filters)
3.
Search for a university (e.g., "Harvard")
4.
Click "Apply Now" on any result
5.
Register on Eduxa (use a test email)
6.
Contact Eduxa support to confirm attribution
What You Should See#
University search interface with filters
Search results with university cards
"Apply Now" buttons on each university
Smooth iframe integration with no border
Troubleshooting#
Problem: The page loads but no search widget appears.✅ Verify you replaced YOUR_AGENCY_KEY with your actual API key
✅ Check that the <div id="eduxa_university_search"></div> exists
✅ Open browser console (F12) and check for JavaScript errors
✅ Ensure your page is served over HTTPS (HTTP may be blocked)
"Invalid Agency" Error#
Problem: Error message appears in the iframe.✅ Confirm your domain is whitelisted with Eduxa
✅ Verify you're using the correct API key
✅ Check that your API key status is "active"
✅ Contact Eduxa support to verify configuration
✅ Add custom CSS to adjust iframe height (see Customization section)
✅ The default height is 650px but varies by content
✅ Use min-height instead of fixed height for flexibility
Attribution Not Working#
Problem: Students register but aren't attributed to your agency.✅ Verify the widget loaded before the student clicked "Apply Now"
✅ Check that cookies are enabled in the student's browser
✅ Ensure the student didn't already have an account
✅ Contact Eduxa support with the student's email for manual verification
Multiple Page Implementation#
You can use the same embed code on multiple pages of your site:✅ /study-abroad
✅ /universities
✅ /programs/usa
✅ /programs/uk
✅ /apply-now
Advanced Use Cases#
Landing Page Integration#
Blog/Article Integration#
Embed the widget mid-article for contextual placement:
Security & Privacy#
Data Protection#
✅ Secure HTTPS connection required
✅ No personal data transmitted to your site
✅ GDPR compliant attribution cookies
✅ Domain whitelisting prevents unauthorized use
eduxa_agency) to track attribution:Purpose: Agency attribution only
Type: HttpOnly, Secure, SameSite=Lax
Support & Documentation#
Need Help?#
💬 Live Chat: Available on eduxa.com
Feedback#
We'd love to hear how the widget works for you! Contact us with:
Examples Gallery#
Minimal Integration#
With Custom Styling#
Full Landing Page#
See "Advanced Use Cases" section above for complete landing page example.
Frequently Asked Questions#
Q: Can I use the widget on multiple websites?
A: Yes, but each domain must be whitelisted. Contact Eduxa support to add additional domains.Q: Does it work with single-page applications (React/Vue/Angular)?
A: Yes! Just ensure the <div id="eduxa_university_search"></div> exists in the DOM before the script loads.Q: Can I customize the widget's appearance?
A: You can style the container, but the iframe content is controlled by Eduxa for consistent branding.Q: What happens if my API key is leaked?
A: Domain whitelisting protects you. The key only works on your registered domains. Contact support immediately to rotate your key.Q: How do I track conversions?
A: Contact Eduxa for dashboard access where you can see:Total attributed registrations
Revenue tracking (if applicable)
A: Contact Eduxa sales for pricing information based on your partnership agreement.
Version History#
v1.0.0 (January 2025): Initial releaseUniversity search interface
Automatic attribution via secure cookies
Legal#
By embedding this widget, you agree to:Agency Partnership Agreement
Modified at 2026-01-08 09:11:39
