Linking and deep links
If you are linking to the volunteer platform from your own site, these are the URLs that are stable and safe to hardcode.
Pages
| URL | What it shows |
|---|---|
/needs | Everything published. The default landing page. |
/needs/<slug> | One opportunity. This is the link to share. |
/orgs | Every approved organization. |
/orgs/<slug> | One organization’s public profile, with everything it has published. |
/campaigns | Active campaigns. |
/campaigns/<slug> | One campaign. |
/malama | The Mālama Hawaiʻi programme. |
/join | Create a volunteer account. |
/orgs/register | Register an organization. |
/profile | The signed-in volunteer’s profile. |
Opportunities and organizations are addressed by slug, not by id, and slugs are stable. The one
place an id appears in a URL is an organization’s own dashboard,
/orgs/<id>/dashboard, which is not a public page.
Filters are in the URL
Every filter on /needs is written into the address as a visitor sets it, so a filtered list is
something you can bookmark, send, or link to from your own page.
| Parameter | Repeatable | Value |
|---|---|---|
island | Yes | Island slug: oahu, maui, hawaii, kauai, molokai, lanai, kahoolawe, remote |
cause | Yes | Cause slug, such as food-insecurity or environmental-conservation |
activity_type | Yes | Activity slug, such as beach-ocean or teaching-training |
good_for | Yes | Good-for slug, such as families, teens, groups, visitors |
org | Yes | Organization slug |
affiliation | Yes | Affiliation slug |
date_type | No | one_time, recurring, or open_ended |
commitment | No | one_time or ongoing |
start_date, end_date | No | YYYY-MM-DD |
q | No | Free-text search |
sort | No | upcoming (default, omitted) or popular |
favorites | No | 1 to show only the signed-in volunteer’s saved opportunities |
open_dates | No | 0 to leave out open-ended opportunities |
malama | No | 1 for Mālama Hawaiʻi certified organizations only |
view | No | map for the map view. Omitted for the default card view |
Repeatable parameters are ORs: two island values mean either island.
https://needs.kanuhawaii.org/needs?island=maui&cause=environmental-conservation&good_for=families
https://needs.kanuhawaii.org/needs?org=your-organization-slug
https://needs.kanuhawaii.org/needs?malama=1&view=mapThe simplest way to build one is to set the filters on the site and copy the address bar.
Slugs come from lookup lists Kanu Hawaii maintains, and a value that does not match one is ignored rather than erroring, which looks like a filter that did nothing. Copy them from a working URL.
Linking versus embedding
Link when you want somebody to end up on the platform, with everything it offers: the map, saved opportunities, their own hours.
Embed when you want people to stay on your page. The widget filters server-side and carries its own signup, so a visitor never leaves.
The two take the same shape of filter. If you have a link that shows the right opportunities, the embed builder will produce a widget showing the same set.
Opportunity pages are meant to be shared
Every opportunity page carries its own title, description, and image for link previews, so pasting one into Slack or a Facebook post produces something that looks like the opportunity rather than a bare URL. Each listing also has Share buttons for Facebook, X, email, and copying the link.
Share the /needs/<slug> URL rather than a link to a filtered list when you mean one specific
opportunity.