
Documentation
Webflow
Code
Setup: External Scripts
External Scripts in Webflow
Make sure to always put the External Scripts before the Javascript step of the resource.
In this video you learn where to put these in your Webflow project? Or how to include a paid GSAP Club plugin in your project?
HTML
Step 1: Copy structure to Webflow
Copy structure to Webflow
In the video below we described how you can copy + paste the structure of this resource to your Webflow project.
Copy to Webflow
Webflow structure is not required for this resource.
Step 1: Add HTML
HTML
<div data-filter-group="" data-filter-target-match="multi" data-filter-name-match="single" role="group" class="filter-group">
<div class="filter-buttons">
<button data-filter-target="all" data-filter-status="active" aria-pressed="false" aria-controls="filter-list" class="filter-btn">All</button>
<button data-filter-target="orange" data-filter-status="not-active" aria-pressed="false" aria-controls="filter-list" class="filter-btn">Orange</button>
<button data-filter-target="blue" data-filter-status="not-active" aria-pressed="false" aria-controls="filter-list" class="filter-btn">Blue</button>
<button data-filter-target="green" data-filter-status="not-active" aria-pressed="false" aria-controls="filter-list" class="filter-btn">Green</button>
<button data-filter-target="brown" data-filter-status="not-active" aria-pressed="false" aria-controls="filter-list" class="filter-btn">Brown</button>
<button data-filter-target="reset" data-filter-status="not-active" aria-pressed="false" aria-controls="filter-list" class="reset-btn">Reset</button>
</div>
<div aria-live="polite" role="list" class="filter-list">
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🐸</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="green" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Green</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Frog</h3>
</div>
</div>
</div>
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🦜</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="green" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Green</p>
</div>
<div data-filter-name-collect="orange" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Orange</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Parrot</h3>
</div>
</div>
</div>
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🦎</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="green" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Green</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Gecko</h3>
</div>
</div>
</div>
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🦄</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="orange" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Orange</p>
</div>
<div data-filter-name-collect="blue" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Blue</p>
</div>
<div data-filter-name-collect="green" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Green</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Unicorn</h3>
</div>
</div>
</div>
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🐳</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="blue" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Blue</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Whale</h3>
</div>
</div>
</div>
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🦞</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="orange" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Orange</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Lobster</h3>
</div>
</div>
</div>
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🐅</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="orange" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Orange</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Tiger</h3>
</div>
</div>
</div>
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🦁</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="orange" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Orange</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Lion</h3>
</div>
</div>
</div>
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🐛</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="green" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Green</p>
</div>
<div data-filter-name-collect="orange" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Orange</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Caterpillar</h3>
</div>
</div>
</div>
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🦋</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="blue" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Blue</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Butterfly</h3>
</div>
</div>
</div>
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🐻</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="brown" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Brown</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Brown Bear</h3>
</div>
</div>
</div>
<div role="listitem" data-filter-name="" data-filter-status="active" class="filter-list__item">
<div class="demo-card">
<div class="demo-card__top">
<div class="demo-card__visual">
<div class="demo-card__visual-before"></div>
<span class="demo-card__emoji">🦇</span>
</div>
<div class="demo-card__tags-collection">
<div class="demo-card__tags-list">
<div data-filter-name-collect="brown" class="demo-card__tags-item">
<p class="demo-card__tags-item-p">Brown</p>
</div>
</div>
</div>
</div>
<div class="demo-card__bottom">
<h3 class="demo-card__h3">Bat</h3>
</div>
</div>
</div>
</div>
</div>
HTML structure is not required for this resource.
Step 2: Add CSS
CSS
.filter-group {
min-height: 100vh;
padding-bottom: 10em;
}
/* Filter Buttons */
.filter-buttons {
grid-column-gap: .5em;
grid-row-gap: .5em;
flex-flow: wrap;
justify-content: flex-start;
padding: 1em 1em 3em;
display: flex;
}
.filter-btn {
-webkit-appearance: none;
appearance: none;
background-color: #efeeec;
border-radius: 10em;
padding: .65em 1.25em;
font-size: 1.5em;
transition: color 0.6s cubic-bezier(0.625, 0.05, 0, 1), background-color 0.6s cubic-bezier(0.625, 0.05, 0, 1);
}
.filter-btn[data-filter-status="active"] {
background-color: #131313;
color: #EFEEEC;
}
/* Reset Button */
.reset-btn {
outline-offset: -2px;
color: #c90f0f;
-webkit-appearance: none;
appearance: none;
background-color: #c90f0f0d;
border-radius: 10em;
outline: 2px solid #c90f0f;
padding: .65em 1.25em;
font-size: 1.5em;
transition: all 0.6s cubic-bezier(0.625, 0.05, 0, 1);
opacity: 0;
visibility: hidden;
}
.reset-btn[data-filter-status="active"] {
opacity: 1;
visibility: visible;
}
/* Filter List */
.filter-list {
flex-flow: wrap;
width: 100%;
display: flex;
}
.filter-list__item {
width: 25%;
padding: .75em;
}
.filter-list__item[data-filter-status="active"] {
transition: opacity 0.6s cubic-bezier(0.625, 0.05, 0, 1), transform 0.6s cubic-bezier(0.625, 0.05, 0, 1);
transform: scale(1) rotate(0.001deg);
opacity: 1;
visibility: visible;
position: relative;
}
.filter-list__item[data-filter-status="transition-out"] {
transition: opacity 0.45s cubic-bezier(0.625, 0.05, 0, 1), transform 0.45s cubic-bezier(0.625, 0.05, 0, 1);
transform: scale(0.9) rotate(0.001deg);
opacity: 0;
visibility: visible;
}
.filter-list__item[data-filter-status="not-active"] {
transform: scale(0.9) rotate(0.001deg);
opacity: 0;
visibility: hidden;
position: absolute;
}
/* Demo Card */
.demo-card {
grid-column-gap: 1em;
grid-row-gap: 1em;
background-color: #efeeec;
border-radius: 1.5em;
flex-flow: column;
width: 100%;
padding: 1em;
display: flex;
}
.demo-card__top {
position: relative;
}
.demo-card__bottom {
justify-content: flex-start;
align-items: center;
padding-bottom: .25em;
padding-left: .5em;
padding-right: .5em;
display: flex;
}
.demo-card__h3 {
margin-top: 0;
margin-bottom: 0;
font-size: 1.25em;
font-weight: 500;
line-height: 1;
}
.demo-card__visual {
background-color: #e2dfdf;
border-radius: .5em;
justify-content: center;
align-items: center;
width: 100%;
display: flex;
position: relative;
}
.demo-card__visual-before {
padding-top: 66%;
}
.demo-title {
padding: 10em 1em 2em;
}
.demo-title__h2 {
font-size: 5em;
font-weight: 500;
line-height: 1;
}
.demo-card__emoji {
font-size: 4em;
}
.demo-card__tags-collection {
width: 100%;
padding: 1em;
position: absolute;
top: 0;
left: 0;
}
.demo-card__tags-list {
display: flex;
}
.demo-card__tags-item {
background-color: #efeeec;
border-radius: 3em;
padding: .25em .75em;
}
.demo-card__tags-item-p {
margin-bottom: 0;
font-size: .875em;
}
@media screen and (max-width: 991px) {
.filter-list__item {
width: 50%;
}
}
@media screen and (max-width: 767px) {
.filter-list__item {
width: 100%;
}
}
Step 2: Add custom Javascript
Custom Javascript in Webflow
In this video, Ilja gives you some guidance about using JavaScript in Webflow:
Step 2: Add Javascript
Step 3: Add Javascript
Javascript
function initMutliFilterSetupMultiMatch(){
const transitionDelay = 300;
const groups = [...document.querySelectorAll('[data-filter-group]')];
groups.forEach(group => {
const targetMatch = (group.getAttribute('data-filter-target-match') || 'multi').trim().toLowerCase(); // 'single' | 'multi'
const nameMatch = (group.getAttribute('data-filter-name-match') || 'multi').trim().toLowerCase(); // 'single' | 'multi'
const buttons = [...group.querySelectorAll('[data-filter-target]')];
const items = [...group.querySelectorAll('[data-filter-name]')];
// Collect tokens from children if present
items.forEach(item => {
const collectors = item.querySelectorAll('[data-filter-name-collect]');
if (!collectors.length) return;
const seen = new Set(), tokens = [];
collectors.forEach(c => {
const v = (c.getAttribute('data-filter-name-collect') || '').trim().toLowerCase();
if (v && !seen.has(v)) {
seen.add(v);
tokens.push(v);
}
});
if (tokens.length) item.setAttribute('data-filter-name', tokens.join(' '));
});
// Cache item tokens
const itemTokens = new Map();
items.forEach(el => {
const raw = (el.getAttribute('data-filter-name') || '').trim().toLowerCase();
const tokens = raw ? raw.split(/\s+/).filter(Boolean) : [];
itemTokens.set(el, new Set(tokens));
});
const setItemState = (el, on) => {
const next = on ? 'active' : 'not-active';
if (el.getAttribute('data-filter-status') !== next) {
el.setAttribute('data-filter-status', next);
el.setAttribute('aria-hidden', on ? 'false' : 'true');
}
};
const setButtonState = (btn, on) => {
const next = on ? 'active' : 'not-active';
if (btn.getAttribute('data-filter-status') !== next) {
btn.setAttribute('data-filter-status', next);
btn.setAttribute('aria-pressed', on ? 'true' : 'false');
}
};
// Active tags model
let activeTags = targetMatch === 'single' ? null : new Set(['all']);
const hasRealActive = () => {
if (targetMatch === 'single') return activeTags !== null;
return activeTags.size > 0 && !activeTags.has('all');
};
const resetAll = () => {
if (targetMatch === 'single') {
activeTags = null;
} else {
activeTags.clear();
activeTags.add('all');
}
};
// Matching logic
const itemMatches = (el) => {
if (!hasRealActive()) return true;
const tokens = itemTokens.get(el);
if (targetMatch === 'single') {
return tokens.has(activeTags);
} else {
const selected = [...activeTags];
if (nameMatch === 'single') {
// AND logic: must contain all selected
for (let i = 0; i < selected.length; i++) {
if (!tokens.has(selected[i])) return false;
}
return true;
} else {
// OR logic: must contain any selected
for (let i = 0; i < selected.length; i++) {
if (tokens.has(selected[i])) return true;
}
return false;
}
}
};
const paint = (rawTarget) => {
const target = (rawTarget || '').trim().toLowerCase();
if ((target === 'all' || target === 'reset') && !hasRealActive()) return;
if (target === 'all' || target === 'reset') {
resetAll();
} else if (targetMatch === 'single') {
activeTags = target;
} else {
if (activeTags.has('all')) activeTags.delete('all');
if (activeTags.has(target)) activeTags.delete(target);
else activeTags.add(target);
if (activeTags.size === 0) resetAll();
}
// Update items
items.forEach(el => {
if (el._ft) clearTimeout(el._ft);
const next = itemMatches(el);
const cur = el.getAttribute('data-filter-status');
if (cur === 'active' && transitionDelay > 0) {
el.setAttribute('data-filter-status','transition-out');
el._ft = setTimeout(() => { setItemState(el, next); el._ft = null; }, transitionDelay);
} else if (transitionDelay > 0) {
el._ft = setTimeout(() => { setItemState(el, next); el._ft = null; }, transitionDelay);
} else {
setItemState(el, next);
}
});
// Update buttons
buttons.forEach(btn => {
const t = (btn.getAttribute('data-filter-target') || '').trim().toLowerCase();
let on = false;
if (t === 'all') on = !hasRealActive();
else if (t === 'reset') on = hasRealActive();
else on = targetMatch === 'single' ? activeTags === t : activeTags.has(t);
setButtonState(btn, on);
});
};
group.addEventListener('click', e => {
const btn = e.target.closest('[data-filter-target]');
if (btn && group.contains(btn)) paint(btn.getAttribute('data-filter-target'));
});
paint('all');
});
}
// Initialize Multi Filter Setup (Multi Match)
document.addEventListener('DOMContentLoaded', () => {
initMutliFilterSetupMultiMatch();
});
Step 3: Add custom CSS
Step 2: Add custom CSS
Custom CSS in Webflow
Curious about where to put custom CSS in Webflow? Ilja explains it in the below video:
CSS
/* Filter Button */
.filter-btn {
transition: color 0.6s cubic-bezier(0.625, 0.05, 0, 1), background-color 0.6s cubic-bezier(0.625, 0.05, 0, 1);
}
.filter-btn[data-filter-status="active"] {
background-color: #131313;
color: #EFEEEC;
}
/* Reset Button */
.reset-btn {
transition: all 0.6s cubic-bezier(0.625, 0.05, 0, 1);
opacity: 0;
visibility: hidden;
}
.reset-btn[data-filter-status="active"] {
opacity: 1;
visibility: visible;
}
/* Filter List Item */
.filter-list__item[data-filter-status="active"] {
transition: opacity 0.6s cubic-bezier(0.625, 0.05, 0, 1), transform 0.6s cubic-bezier(0.625, 0.05, 0, 1);
transform: scale(1) rotate(0.001deg);
opacity: 1;
visibility: visible;
position: relative;
}
.filter-list__item[data-filter-status="transition-out"] {
transition: opacity 0.45s cubic-bezier(0.625, 0.05, 0, 1), transform 0.45s cubic-bezier(0.625, 0.05, 0, 1);
transform: scale(0.9) rotate(0.001deg);
opacity: 0;
visibility: visible;
}
.filter-list__item[data-filter-status="not-active"] {
transform: scale(0.9) rotate(0.001deg);
opacity: 0;
visibility: hidden;
position: absolute;
}
Implementation
Filter Group
A container with the [data-filter-group]
attribute that keeps buttons and items organised, ensuring multiple groups on the page function independently.
Use [data-filter-target-match="single/multi"]
to decide if clicking buttons selects exactly one tag or allows combining multiple tags.
Use [data-filter-name-match="single/multi"]
to control item matching, where "single" requires an item’s [data-filter-name]
to contain all selected tags and "multi" matches when it contains any selected tag.
Filter Button
Buttons with the [data-filter-target="example"]
attribute indicate which items to display, while the [data-filter-status]
attribute tracks whether a button is active or not. Make sure to not use spaces. When a filter is made out of multiple words use: [data-filter-target="blue-birds"]
.
Filter Item
Items to be filtered are identified by the [data-filter-name="example"]
attribute, matching the target of a button, and their visibility is controlled by the [data-filter-status]
attribute. When a filter is made out of multiple words use: [data-filter-name="blue-birds"]
. When the item is connected to multiple buttons use a space between the names in the attribute, for example: [data-filter-name="mammals aquatic"]
.
Filter Status (not-active, active, transition-out)
The [data-filter-status]
attribute determines an item’s state:
- active: Makes the item visible.
- not-active: Hides the item.
- transition-out: Temporarily applied to items for smooth animations when transitioning from active to not-active. Items remain in this state for a specified duration (
transitionDelay
in JavaScript, in milliseconds: 300ms = 0.3s) before their final state is set.
Multiple keywords
You can assign multiple keywords to a single filter item by separating them with a space. For example: [data-filter-name="mammals aquatic"]
Name Collect *Optional for Webflow users
Use children marked with [data-filter-name-collect]
inside an item to auto-build the parent’s [data-filter-name]
from unique tokens without duplicates.
Example item setup:
<div class="demo-card" data-filter-name="">
<div> <!-- Webflow Collection -->
<div> <!-- Webflow Collection List -->
<div> <!-- Webflow Collection Item -->
<div data-filter-name-collect="mammals"></div>
</div>
<div> <!-- Webflow Collection Item -->
<div data-filter-name-collect="aquatic"></div>
</div>
</div>
</div>
</div>
<!-- becomes: data-filter-name="mammals aquatic" -->
All button
A special button with [data-filter-target="all"]
will display all items in the group when clicked, regardless of their data-filter-name. This button also uses [data-filter-status] to indicate if it is active or not.
Reset button
A special button with [data-filter-target="reset"]
will display all items in the group when clicked. This button also uses [data-filter-status]
to indicate if it is active or not. The key difference with the all button is that it's not-active when all items are visible. And active when a specific filter is active.
Other Filter Setups
Resource Details
Last updated
August 18, 2025
Type
The Vault
Category
Filters & Sorting
Need help?
Join Slack