In some situations, opening a URL in the device's default browser provides a better experience than using the in-app browser. This is especially important for links that require authentication (such as Google login), which may not function correctly inside an in-app browser.
To support this, Amego allows URLs to open in the device's default browser within a modal window, so attendees don't have to fully leave the app.
This article explains how to use amego_target=modal to open any URL in the default browser modal.
When Should I Use the Default Browser Modal?
You should consider using the default browser modal when:
- A URL requires login or authentication (for example, Google sign-in)
- A third-party site does not load correctly in the in-app browser
- You want to preserve the attendee's place in the app while displaying external content
How It Works
By adding amego_target=modal to the end of a URL, you instruct the app to open that link in the device's default browser while keeping it contained inside a modal overlay.
The Basic Rule
Add ?amego_target=modal or &amego_target=modal to the end of your URL:
- Use
?if the URL does not already contain parameters - Use
&if the URL already contains one or more parameters
Examples
Case 1: Simple Domain Only
Before: https://example.com After: https://example.com?amego_target=modal
Case 2: Domain With a Path
Before: https://example.com/products After: https://example.com/products?amego_target=modal
Case 3: URL With One Parameter
Before: https://example.com/search?q=shoes After: https://example.com/search?q=shoes&amego_target=modal
Case 4: URL With Multiple Parameters
Before: https://example.com/products?category=electronics&sort=price After: https://example.com/products?category=electronics&sort=price&amego_target=modal
Case 5: URL With a Path and Multiple Parameters
Before: https://shop.example.com/checkout?item=123&quantity=2 After: https://shop.example.com/checkout?item=123&quantity=2&amego_target=modal
Quick Tip
Check your URL before adding the parameter:
- No
?present → add?amego_target=modal ?already present → add&amego_target=modal
Where Can This Be Used?
You can apply amego_target=modal to URLs in multiple areas of the Amego CMS, including:
- Custom links
- Speaker or sponsor links
- Content descriptions
- External resources
Summary
Using amego_target=modal ensures that external links open reliably while keeping attendees inside the app. This is especially helpful for login-required URLs and third-party tools that perform best in the device's default browser.