FAQ - Obvlo Developer Docs

Use the sections below to find answers by category.

Portal FAQs

Question	Answer
I have not received my login email. What should I do?	Check spam first. If you still cannot find it, go to portal.obvlo.com and use Forgot Password with your invited email.
My welcome link no longer works.	This is expected after 24 hours. Use Forgot Password with your invited email, or use Google Sign-In if your account has already been invited.
Where do I manage content in Portal?	Go to Destinations, select your destination, then open Review Content.
Can I change copy on a listing or guide?	Yes. You can edit names, descriptions, and listing fields directly in Portal and publish updates.
Can I add a place that is not already in the database?	Yes, as long as the place exists as a business listing in Google Maps.
How do I update the handbook?	Go to Destinations, choose your destination, then open Pages and Manage Information Page.
Can multiple team members review content at the same time?	Yes. Teams can collaborate in Portal, but it helps to assign one owner for final approval so launch readiness is clear.

Web App FAQs

Question	Answer
How quickly can we launch Web App?	Web App is the fastest path for most teams because Obvlo hosts and maintains it. Your main work is content approval and distribution planning.
Do we need to host any frontend infrastructure?	No. Web App is hosted by Obvlo and delivered by URL or QR.
Can we personalise the guest journey?	Yes. Web App can capture traveller context and adjust recommendation ranking to improve relevance.
When should we choose Web App over Widget?	Choose Web App when you want a full hosted guest experience. Choose Widget when you want the experience embedded inside your existing website.

Question	Answer
How does the widget’s data capture feature benefit us?	Data Capture collects traveller preferences in a simple way, so you can show more relevant recommendations without manual data collection.
How do personalised recommendations work?	Recommendations are ranked and filtered using three layers. Traveller inputs — traveller type, interests, and trip type — adjust which guides and listings are most relevant to each user. External factors — weather, time of day, and time of year — further shape what is surfaced in context. Editorial priority gives your team control: guides marked as Featured are ranked above non-featured guides across all delivery channels, making them useful for highlighting partner venues or owned outlets.
How does responsive design improve user experience?	The widget adapts to screen size automatically, so guests get a consistent experience across desktop, tablet, and mobile.
Can I customise the widget to fit my brand?	Yes. You can configure colours, images, logos, and supported fonts. See Widget configuration reference for available options.
How do I ensure the widget is functioning correctly on my site?	Run an end-to-end check across key devices and browsers. Confirm branding, content accuracy, and responsive behaviour before go-live.
Does the widget support analytics tracking?	Yes. If your site uses Google Analytics, events are sent automatically with no setup. For other analytics providers, add a JavaScript event listener on the page. See Analytics events for implementation detail.
Where do I find my Destination ID (host-id)?	In the Portal, go to Destinations. The value is listed in the Destination ID column. This is the `host-id` used in widget setup. See Widget quick start.
Should I use `defer` or `async` when loading the widget script?	Use `defer` if other scripts on the page depend on the widget being initialised first — it guarantees execution order. Use `async` if the widget is fully independent and you want it to execute as soon as it downloads. See Widget quick start.
Can I display a specific guide or area when the widget loads?	Yes. Use the `guide-id` attribute to open a specific guide, or `neighbourhood-id` to open a specific area. See Configuration reference for usage.
How do I set the widget display language?	Use the `lang` attribute with a language-dialect code, for example `en-GB` or `fr-FR`. See Configuration reference for supported codes.
Why does the widget map fail in development but work in production?	This usually comes from Google Places API key permissions. In production, the host key is typically configured correctly. In development or staging, restricted or mismatched key settings can block map rendering. See Widget quick start for configuration guidance.

Microsite FAQs

Question	Answer
What is Microsite best used for?	Microsite is best when search visibility and destination discoverability are priorities, especially across SEO, GEO, and AEO journeys.
Do we need our own CMS to use Microsite?	No. Obvlo hosts and maintains Microsite pages. Your team manages content and publishing through Portal.
Can Microsite pages sit under our own domain?	Yes. Microsite is served under your domain using reverse proxy. See Reverse proxy setup for configuration.
Is the reverse proxy required?	Without the reverse proxy, the full SEO and domain authority benefit of Microsite is not realised. Pages will still work, but authority accrues to the Obvlo domain rather than yours. See Reverse proxy setup.
Does Microsite support multiple languages?	Yes. Pages are generated in all languages configured for your site, each independently indexed. See the Language reference for all 63 supported languages.
Do I need to add the Microsite sitemap to my domain’s sitemap_index.xml?	Yes. Without the reference, search engine crawlers may not discover Microsite pages during their scheduled crawl of your domain. See Microsite overview for the correct format.
How do we monitor Microsite performance?	Use Reports and your analytics setup to monitor engagement, search signals, and ranking movement.

API FAQs

Question	Answer
Where should teams start with API delivery?	Start with API overview, then review Authentication and API Reference.
Where is endpoint-level detail?	Use API Reference for endpoint definitions, payloads, and response details.
When should we choose API instead of hosted channels?	Use API when your team needs full control over frontend behaviour across your own apps or services.
Do preview endpoints behave differently from stable endpoints?	Yes. Stable endpoints are for predictable production use. Preview endpoints can evolve faster and should be validated before release.
How should we handle rate limits and failures?	Implement retries, validation checks, and logging in your integration layer.

Reporting and analytics FAQs

Question	Answer
Why is Reporting empty after launch prep?	Reporting starts populating after the live experience is active and guests begin interacting with content.
What is the difference between Analytics and Reports?	Analytics is the event data feed for your analytics tools. See Analytics events. Reports are in-Portal dashboards for day-to-day monitoring. See Reporting.
Can we export data for stakeholder updates?	Yes. Reports supports export workflows so teams can share offline updates and reviews.

Help FAQs

Question	Answer
Where should our team start?	Start with Getting Started, then review the relevant onboarding guide for your delivery path.
How do we choose the right implementation path?	Use Step 4: Using your content. It maps goals to Web App, Embeddable Widget, Microsite, or API.
Where can I track planned work and product updates?	Use the Change log for product updates.
How do we get support?	Contact your account manager or email support@obvlo.com.

⌘I