Build custom Excel reports from monday.com board data and send them automatically to the right people on schedule.
Advanced features
Customize embedded monday.com board widgets with URL parameters
Use URL parameters to filter groups and columns or override individual settings when using an embedded monday.com board widget on different pages or in different contexts.
Filter by groups
Board items are organized across groups
You have one board containing all your items, and those items are separated by groups. And you want to only display items per group across multiple website pages or sections.
In this example, we have products on different categories and we only want to embed the Barstool group products. The default widget URL looks like this, showing all products:
https://widgets.getgorilla.app/66c9df7655546acb?type=embed
By simply adding the filter_group parameter and passing in the designated group name, you can narrow down the displayed items further:
https://widgets.getgorilla.app/66c9df7655546acb?type=embed&filter_group=Barstool
Did you know?
If your group name contains blank spaces, you should replace those with %20 to encode the URL properly:
https://widgets.getgorilla.app/3fdb3798bab9c146?type=embed&filter_group=Under%20consideration
Filter by column
Embed one widget multiple times with different filters
You can add specific filters to your widget URL with a query parameter which looks like ?filter_<columnID>=value. That way you can embed the same website widget multiple times into your website, but apply different filters per widget. You can also apply multiple filters to a widget, such as ?filter_<columnID>=value&filter_<columnID>=value. Find the columnID under Column settings by clicking the ⚙ button next to the column name.
Lets take a look at real examples, the default widget URL looks like this, showing all products:
https://widgets.getgorilla.app/66c9df7655546acb?type=embed
Here we filter all items that have exactly only Brown as color:
https://widgets.getgorilla.app/66c9df7655546acb?type=embed&filter_text2=Brown
The following filters items, where the color contains Brown:
https://widgets.getgorilla.app/66c9df7655546acb?type=embed&filter_text2|contains=Brown
And here we filter for where the color contains Brown and the material Wood:
Did you know?
If you want to embed the same widget multiple times on the same page, you additionally have to index each widget ID to make it unique. Taking the last two examples from above to illustrate it better below.
First widget with the following snippet, where both IDs have a -1 suffix in the iframe and last script tag:
<script src="https://widgets.getgorilla.app/resizer/iframeResizer.min.js"></script><iframe id="widget-66c9df7655546acb-1" src="https://widgets.getgorilla.app/66c9df7655546acb?type=embed&filter_text2|contains=Brown&setting_bodyPadding=small" style="width:1px;min-width:100%;border:0;"></iframe><script>iFrameResize({ log: false }, '#widget-66c9df7655546acb-1');</script>
Second widget with the following snippet, where both IDs have a -2 suffix in the iframe and last script tag:
<script src="https://widgets.getgorilla.app/resizer/iframeResizer.min.js"></script><iframe id="widget-66c9df7655546acb-2" src="https://widgets.getgorilla.app/66c9df7655546acb?type=embed&filter_text2|contains=Brown&filter_text|contains=Wood&setting_bodyPadding=small" style="width:1px;min-width:100%;border:0;"></iframe><script>iFrameResize({ log: false }, '#widget-66c9df7655546acb-2');</script>
Filters in the widget header
A filter_ parameter is applied before the widget is shown. If a status column of that widget is offered as a filter in the widget header, its dropdown only lists labels that still have items left after your URL filter – the two narrow the items down together.
Overwriting settings
Overwriting published settings for specific embeds
Lets stick to the example widget from above and overwrite the widgets background, border and headline colors. The default widget URL looks like this, inheriting its default widget settings:
https://widgets.getgorilla.app/66c9df7655546acb?type=embed
Now lets add three parameters backgroundColor, borderColor and secondaryColor to overwrite the described settings:
Did you know?
Any setting available in the widget editor can be accessed in URL parameters by its name, like shown above. Any non-alphanumeric letter must be encoded. Since we pass in a HEX code color above, we need to encode # to %23.
Settings that belong to a single column – such as Exclude from search, Show as filter or a date format – are part of that column's settings rather than a setting of the widget, and cannot be overwritten with a setting_ parameter. To publish the same board with different column settings, build a second widget on the board instead.