Widgets
A widget is a way to embed a Pozi search input into your website. It provides headless access to Pozi search functionality and returns either a feature, it’s attribute information or a map itself to the user.
You might use a widget on a public facing website for users to find out what day the garabage will be collected for their address, or find public DAs by entering in an application number. Widgets can be configured on layers within the Pozi site, and can leverage searches that are available in the Pozi site.
Overview & Live Demos
1. Data Widget
A data widget displays the attribute information from a layer in the Pozi application. For example we can return the information from the “Waste Collection” Whats Here info card by using the card[waste collection] parameter in the widget URL.
- Live Example: Type ‘3 Queen Street’ to test.
<iframe height="200px" width="100%" overflow="hidden" frameBorder="0" src="https://southerngrampians.pozi.com/#/card[Waste%20Collection]/fieldnames[Next Rubbish Pickup]/fieldnames[Next Recycling Pickup]/fieldnames[Next Organics Pickup]/fontsize[20]/widget[true]"></iframe>Go to the Building & Embedding the Widget section to see how to construct a data widget from scratch.
Real-world Implementations:
- Cardinia Shire Council - Bin Collection Days
- Frankston City Council - Bin Information
- Northern Grampians Shire Council - Bin Collection Date
- City of Greater Bendigo - Bin Night
2. Map Widget
A map widget allows you to embed the Pozi search input, search for a value and then launch the map focus on the search result. See the example which searches for an address and takes you directly to that location in a Pozi map.
- Live Example: Type ‘3 Queen Street’ to test.
<iframe height="200px" width="100%" overflow="hidden" src="https://southerngrampians.pozi.com/#/newtab[true]/widget[true]"></iframe>Go to the Building & Embedding the Widget section to see how to construct a map widget from scratch.
Real-world Implementations:
URL Parameters Reference
Append parameters inside square brackets parameter[value] to your widget URL base: https://<sitename>.pozi.com/#/widget[true]/
| Parameter | Widget Compatibility | Default | Description |
|---|---|---|---|
card | Data Widget | None | Specifies the dataset to return (e.g., card[wastecollection]). Derived from the dataset tab heading in What’s Here results with spaces and underscores removed. |
fieldnames | Data Widget | All fields | Specifies individual fields to display, separated by commas (e.g., fieldnames[Next Rubbish Pickup,Next Recycling Pickup]). |
fieldnameshide | Data Widget | false | Set to true to hide the dataset title row/field names and display only the result values. |
fontsize | Data Widget | 18 | Customizes font size for widget text (e.g., fontsize[20]). |
search | All | 1st available | Specifies which search configuration index to use on the map (default is the first available search on the map). |
map | All | Default map | Directs search queries to use data from a specific Site Manager map instance. |
placeholder | All | "Type address…" | Customizes the search input placeholder text (e.g., placeholder[Search your property...]). New parameter (August 2026). |
redirect | Map Widget | false | Set to true to redirect the host page directly to the map location upon search. |
newtab | Map Widget | false | Set to true to open the map search result in a new browser tab. Note: May trigger popup blockers depending on user browser settings. |
Building & Embedding the Widget
1. Construct the URL
Making a data widget
To build any widget you need to start with your sites URL.
https://<sitename>.pozi.com/#/
Then add your map parameter (for a site manager site)
map[public] for a legacy site leave this out it will default to you public map.
Then the widget parameter so pozi knows to hide the map and just show the search input.
widget[true]
Now your URL will look like this.
https://<sitename>.pozi.com/#/map[public]/widget[true]
This will by default be a data widget showing you the results of your default search. But you can target any card in your map by using the card parameter. For example if I want the results of the waste collection whats here info card I can add card[waste collection]
When you use the card parameter your URL will will look like this.
https://<sitename>.pozi.com/#/map[public]/card[waste collection]/widget[true]
You can fine tune the output further by using the URL Parameters Reference shown above. Experiement with fieldnames[], fontsize[], and the placholder[] text.
Making a map widget
Making a map widget starts the same way as a data widget. We need the:
- Site URL
- Map parameter
- Widget parameter
And either the
- newtab parameter
- redirect parameter
These final two parameters tell the browser whether to load the map into a new tab or redirect the current page to the Pozi app.
A map widget would look like this.
https://<sitename>.pozi.com/#/map[public]/newtab[true]/widget[true]
Mixing up the search
Pozi can also use any other search in your application and this can be passed to the widget as a URL parameter. This can be used with either the data or map widget URLs.
https://<sitename>.pozi.com/#/map[public]/search[schools]/newtab[true]/widget[true]
This means the widget will not use the top most search which is usually “Address”. When you use a different search you usually want to also modify the inputs placeholder, and we can do that with the placeholder[] parameter.
https://<sitename>.pozi.com/#/map[public]/search[schools]/placeholder[Enter a school name]/newtab[true]/widget[true]
2. Embed the iFrame
Insert the constructed URL into the src attribute of an HTML iframe element on your website:
<iframe style="border:none; height: 300px; width: 100%; overflow: hidden;" src="https://<your-URL>"></iframe>Troubleshooting
Missing fields in Data Widget results
- Ensure field names inside
fieldnames[...]match the exact field titles in the source dataset. - If data attributes changed in the QGIS project, update the field names in your URL parameter to match.