✅ Section 6: Best Practices in Webflow - FadiZahhar/WebflowTraining GitHub Wiki
Webflow gives you the freedom to build anything — but without structure, that freedom leads to chaos.
Following a system from the beginning will help you:
-
Avoid messy builds
-
Work faster across projects
-
Scale designs efficiently
-
Collaborate seamlessly with others
Stick to a consistent, predictable naming system:
-
Client-First:
section-hero
,container-default
,text-heading-xl
-
BEM-style (Block Element Modifier):
card
,card__title
,card--dark
-
Easy to read and maintain
-
Encourages modular design
-
Speeds up development
📌 Pick one system and apply it religiously throughout the project.
Before building any section, define your base styles:
-
Heading sizes (H1–H6)
-
Paragraph base
-
Font family
-
Line height and spacing
-
Primary, secondary, neutral, accent
-
Use swatches to sync across elements
-
Margin and padding tokens (
mb-16
,pt-40
) -
Use consistent spacing for rhythm and structure
🔁 Mirror your Figma styles to maintain brand consistency.
Symbols (now called “Components” in Webflow) let you reuse elements across pages.
-
Navbars
-
Footers
-
CTAs
-
Cards
-
Form blocks
Modify base components without duplicating structure.
Example: btn
→ btn is-primary
, btn is-dark
Use semantic HTML5 elements whenever possible:
Purpose | Webflow Element |
---|---|
Header content | |
Main content | |
Navigation | |
Footer | |
Sections | |
Repeating items |
💡 Semantic HTML improves SEO, accessibility, and maintainability.
Start at desktop, then adjust down:
-
Use
%
orauto
widths -
Stack flex items on mobile
-
Adjust padding/margin per breakpoint
-
Preview on all breakpoints during development — not after
📱 Mobile-first thinking is key to a great UX.
Plan your dynamic content in advance:
-
Blog, case studies, team members, services, FAQs, etc.
-
Use reference or multi-reference fields to link related data
-
Design 1 CMS template, populate 100 pages
Webflow's interactions panel allows for:
-
Scroll-triggered animations
-
Hover/focus states
-
Modals and menu toggles
-
Delayed transitions for storytelling
Use with care:
-
Avoid overuse or distraction
-
Maintain accessibility (keyboard/tab access)
Make your site usable for everyone:
-
Add alt text for all images
-
Use meaningful labels for buttons and forms
-
Ensure color contrast is readable
-
Make interactive elements keyboard-accessible
-
Use
aria
labels for assistive tech
🌍 Accessible sites are usable sites. And they’re better for SEO.
-
Use semantic elements for proper structure
-
Set meta titles and descriptions per page
-
Add alt tags and Open Graph images
-
Submit a sitemap via Webflow settings
-
Use clean, descriptive URLs
-
Name sections clearly:
section-home-hero
,section-about-team
-
Keep only active pages in the designer view
-
Archive unused styles and assets
🧼 Treat your Webflow project like clean code: future-you (and your team) will thank you.
“The difference between a freelancer and a design pro is structure.”
With good habits from the start, your Webflow projects will be:
-
Faster to build
-
Easier to maintain
-
Simpler to hand off