[{"data":1,"prerenderedAt":2826},["ShallowReactive",2],{"blog-post-getting-started-framer-components":3,"related-posts-getting-started-framer-components":769},{"id":4,"title":5,"author":6,"body":10,"category":718,"description":719,"extension":720,"featured":721,"image":722,"meta":723,"navigation":721,"path":754,"published":721,"publishedAt":755,"readingTime":756,"robots":757,"seo":758,"slug":759,"stem":760,"tags":761,"updatedAt":767,"__hash__":768},"blog/blog/getting-started-framer-components.md","How to Add Code Components to Framer (Complete Guide for Beginners)",{"name":7,"avatar":8,"bio":9},"Shahul","/shahul-profile-pic.jpg","Founder of FramerHub",{"type":11,"value":12,"toc":682},"minimark",[13,26,33,38,43,46,62,69,73,76,81,84,88,91,95,98,102,105,170,173,177,181,192,203,206,210,249,256,260,263,280,284,294,326,329,333,336,378,382,385,405,409,413,419,423,428,432,440,444,453,457,461,468,472,484,488,495,499,506,510,513,554,557,565,568,588,591,595,598,625,635,639,646,649,654,675],[14,15,16,17,21,22],"p",{},"If you're new to ",[18,19,20],"strong",{},"Framer code components",", you're probably wondering: ",[23,24,25],"em",{},"\"How hard is it to actually add these to my site?\"",[14,27,28,29,32],{},"The honest answer: it's easier than duplicating a frame. This guide walks through exactly how to ",[18,30,31],{},"add code components to Framer",", customize them without touching code, troubleshoot the handful of things that commonly go wrong, and unlock functionality a raw Framer frame simply can't do on its own.",[34,35,37],"h2",{"id":36},"what-are-framer-code-components","What Are Framer Code Components?",[14,39,40,42],{},[18,41,20],{}," are pre-built React components you drop directly into your Framer project, the same way you'd drag in a native frame or shape.",[14,44,45],{},"Think of them as a level up from regular design elements:",[47,48,49,56],"ul",{},[50,51,52,55],"li",{},[18,53,54],{},"Regular frames"," = static shapes, text, and images with Framer's built-in interactions.",[50,57,58,61],{},[18,59,60],{},"Code components"," = interactive elements with real logic underneath — filterable galleries, CMS carousels, animated counters, form validation, scroll-triggered effects.",[14,63,64,65,68],{},"They're built by developers using React and TypeScript, but the entire point is that they're ",[23,66,67],{},"designed for designers"," — every meaningful option is exposed as a control in the Properties Panel, no code editing required.",[34,70,72],{"id":71},"why-use-code-components-in-framer","Why Use Code Components in Framer?",[14,74,75],{},"Here's what a good code component unlocks that native Framer layers generally can't:",[77,78,80],"h3",{"id":79},"_1-advanced-functionality-without-code","1. Advanced Functionality Without Code",[14,82,83],{},"Want a filterable CMS gallery with multi-field filtering? A countdown timer with a real backend-synced deadline? An animated pricing table with plan comparison logic? Code components give you these instantly, instead of hacking together a workaround with overrides and states.",[77,85,87],{"id":86},"_2-save-real-hours-of-build-time","2. Save Real Hours of Build Time",[14,89,90],{},"Instead of spending an afternoon figuring out how to build a custom accordion with the exact animation curve you want, you install a tested one in two minutes and spend that afternoon on the client's actual design instead.",[77,92,94],{"id":93},"_3-professional-looking-sites-faster","3. Professional-Looking Sites, Faster",[14,96,97],{},"High-quality components are already tested across breakpoints, accessibility basics, and performance — you inherit that quality instead of re-deriving it from scratch on every project.",[34,99,101],{"id":100},"code-components-vs-code-overrides-vs-native-layers","Code Components vs. Code Overrides vs. Native Layers",[14,103,104],{},"Beginners often conflate three different things Framer offers. They solve different problems:",[106,107,108,124],"table",{},[109,110,111],"thead",{},[112,113,114,118,121],"tr",{},[115,116,117],"th",{},"Approach",[115,119,120],{},"What it is",[115,122,123],{},"Best for",[125,126,127,141,158],"tbody",{},[112,128,129,135,138],{},[130,131,132],"td",{},[18,133,134],{},"Native layers",[130,136,137],{},"Frames, text, images, Framer's built-in interactions",[130,139,140],{},"Standard layouts, simple hover/tap states, basic scroll effects",[112,142,143,148,155],{},[130,144,145],{},[18,146,147],{},"Code overrides",[130,149,150,151,154],{},"Small React snippets applied ",[23,152,153],{},"on top of"," an existing layer to modify its behavior",[130,156,157],{},"Tweaking one specific interaction (e.g., custom easing, conditional visibility)",[112,159,160,164,167],{},[130,161,162],{},[18,163,60],{},[130,165,166],{},"Standalone React components with their own internal logic and property controls",[130,168,169],{},"Complex, reusable functionality (galleries, filters, forms, carousels)",[14,171,172],{},"If you're not sure which you need: if a native frame with variants and interactions can do it, use that — it's simpler to maintain. If you need logic (filtering, data fetching, complex state), you need a code component. If you just need to tweak how an existing layer behaves in one specific way, a code override is often the lighter-weight fix.",[34,174,176],{"id":175},"how-to-add-code-components-to-framer-step-by-step","How to Add Code Components to Framer (Step-by-Step)",[77,178,180],{"id":179},"step-1-get-the-component-url","Step 1: Get the Component URL",[14,182,183,184,187,188,191],{},"After purchasing a component from ",[18,185,186],{},"FramerHub"," (or any marketplace), you'll receive a ",[18,189,190],{},"component URL",". It looks like this:",[193,194,199],"pre",{"className":195,"code":197,"language":198},[196],"language-text","https://framer.com/m/ComponentName-XyZ1.js\n","text",[200,201,197],"code",{"__ignoreMap":202},"",[14,204,205],{},"Copy this URL to your clipboard — you won't need to download or upload any files manually.",[77,207,209],{"id":208},"step-2-add-the-component-to-your-framer-project","Step 2: Add the Component to Your Framer Project",[211,212,213,218,229,236,242],"ol",{},[50,214,215],{},[18,216,217],{},"Open your Framer project.",[50,219,220,221,224,225,228],{},"Click the ",[18,222,223],{},"\"+\" button"," in the toolbar (or press ",[200,226,227],{},"Cmd/Ctrl + K",").",[50,230,231,232,235],{},"Select ",[18,233,234],{},"\"Code Component\""," from the menu.",[50,237,238,241],{},[18,239,240],{},"Paste the component URL"," into the field.",[50,243,244,245,248],{},"Hit ",[18,246,247],{},"Enter",".",[14,250,251,252,255],{},"That's it — the component now appears in your project's ",[18,253,254],{},"Assets panel",", ready to use on any page.",[77,257,259],{"id":258},"step-3-drag-it-onto-your-canvas","Step 3: Drag It Onto Your Canvas",[14,261,262],{},"Just like any other layer:",[211,264,265,271,277],{},[50,266,267,268,270],{},"Find the component in the ",[18,269,254],{}," (left sidebar).",[50,272,273,276],{},[18,274,275],{},"Drag it onto your canvas",", wherever you need it.",[50,278,279],{},"Resize and reposition it like a normal frame.",[77,281,283],{"id":282},"step-4-customize-the-component","Step 4: Customize the Component",[14,285,286,287,289,290,293],{},"Most ",[18,288,20],{}," ship with a full set of customizable properties in the ",[18,291,292],{},"Properties Panel"," (right sidebar). Typical controls include:",[47,295,296,302,308,314,320],{},[50,297,298,301],{},[18,299,300],{},"Colors"," — primary, secondary, background, text.",[50,303,304,307],{},[18,305,306],{},"Text"," — headings, labels, button copy.",[50,309,310,313],{},[18,311,312],{},"Sizing"," — padding, spacing, width/height, corner radius.",[50,315,316,319],{},[18,317,318],{},"Animation"," — speed, easing curve, trigger (on load, on scroll, on hover).",[50,321,322,325],{},[18,323,324],{},"CMS connections"," — if the component supports it, a dropdown to connect a collection and map fields.",[14,327,328],{},"No code required at any point — just point, click, and adjust.",[34,330,332],{"id":331},"common-setup-mistakes-and-how-to-fix-them","Common Setup Mistakes (And How to Fix Them)",[14,334,335],{},"Even a two-minute install has a few predictable failure points:",[47,337,338,348,354,366,372],{},[50,339,340,343,344,347],{},[18,341,342],{},"Pasting the wrong URL format."," The component URL must end in ",[200,345,346],{},".js"," and come directly from the marketplace listing — pasting a marketing page URL instead of the actual component file URL will fail silently.",[50,349,350,353],{},[18,351,352],{},"Forgetting to connect CMS fields."," A CMS-ready component installed without connecting the collection will show placeholder/demo content. Check the Properties Panel for a \"Collection\" or \"Data Source\" dropdown.",[50,355,356,359,360,365],{},[18,357,358],{},"Stacking too many heavy components on one page."," Each code component adds some JavaScript weight. A page with 8-10 heavy animated components can start to feel sluggish — see our guide on ",[361,362,364],"a",{"href":363},"/blog/optimize-framer-site-performance","optimizing Framer site performance"," if you notice lag.",[50,367,368,371],{},[18,369,370],{},"Not testing responsive behavior."," Some components have separate mobile/tablet property overrides — always check the Breakpoints panel after installing, don't assume desktop settings carry over perfectly.",[50,373,374,377],{},[18,375,376],{},"Using an outdated component URL after a marketplace update."," If a component gets a major version update, older embed URLs may be deprecated — check the marketplace listing for the current URL if something stops working after months of no changes on your end.",[34,379,381],{"id":380},"updating-a-code-component-after-install","Updating a Code Component After Install",[14,383,384],{},"Code components installed via URL update automatically when the developer ships a new version to that same URL — you don't need to reinstall manually in most cases. That said, a few habits keep updates from surprising you mid-project:",[47,386,387,393,399],{},[50,388,389,392],{},[18,390,391],{},"Check the changelog before a client handoff."," If a component received a major update recently, verify your specific property configuration still looks right before delivering the final site.",[50,394,395,398],{},[18,396,397],{},"Screenshot key pages before a known update window."," If a marketplace announces a breaking change to a component you rely on heavily, a quick before/after comparison saves debugging time later.",[50,400,401,404],{},[18,402,403],{},"Don't panic over minor visual shifts."," A well-maintained component library treats visual changes as intentional improvements (better default spacing, refined animation curves), not bugs — check the release notes before assuming something broke.",[34,406,408],{"id":407},"common-questions-about-framer-code-components","Common Questions About Framer Code Components",[77,410,412],{"id":411},"q-do-i-need-to-know-react-to-use-code-components","Q: Do I need to know React to use code components?",[14,414,415,418],{},[18,416,417],{},"A:"," No. Code components are designed to be used by designers. You customize them through the Properties Panel, just like regular frames — React knowledge is only relevant if you choose to edit the underlying code.",[77,420,422],{"id":421},"q-can-i-edit-the-code-inside-a-component","Q: Can I edit the code inside a component?",[14,424,425,427],{},[18,426,417],{}," Yes, if you want to. You can \"Unlink\" a component and edit the code directly. But most users never need to do this — the exposed controls cover nearly every customization a typical project needs.",[77,429,431],{"id":430},"q-will-code-components-slow-down-my-site","Q: Will code components slow down my site?",[14,433,434,436,437,439],{},[18,435,417],{}," Not if they're built well. High-quality components (like those from ",[18,438,186],{},") are optimized for performance, using memoization and minimal bundle size so they don't add noticeable load time.",[77,441,443],{"id":442},"q-can-i-use-code-components-with-framer-cms","Q: Can I use code components with Framer CMS?",[14,445,446,448,449,452],{},[18,447,417],{}," Absolutely. Many components are ",[23,450,451],{},"designed"," for CMS integration — filterable galleries, dynamic cards, CMS-connected carousels are common use cases.",[34,454,456],{"id":455},"pro-tips-for-using-framer-code-components","Pro Tips for Using Framer Code Components",[77,458,460],{"id":459},"_1-use-component-variants","1. Use Component Variants",[14,462,463,464,467],{},"Many components have built-in ",[18,465,466],{},"variants"," (Light/Dark, Small/Large, Compact/Expanded). Use these to match your design system instead of manually restyling every instance.",[77,469,471],{"id":470},"_2-create-master-components","2. Create Master Components",[14,473,474,475,478,479,483],{},"If you use the same code component across multiple pages, wrap it in a ",[18,476,477],{},"Master Component"," so changes sync everywhere it's used. This is the foundation of ",[361,480,482],{"href":481},"/blog/scalable-framer-architecture-for-agencies","scalable agency architecture"," — one place to update, not a dozen.",[77,485,487],{"id":486},"_3-test-on-mobile-early-not-last","3. Test on Mobile Early, Not Last",[14,489,490,491,494],{},"Always preview on mobile ",[23,492,493],{},"before"," you've finished the whole page. Some components expose separate responsive properties you'll want to adjust per breakpoint, and catching this early avoids a rebuild pass at the end.",[77,496,498],{"id":497},"_4-start-with-a-library-not-one-off-purchases","4. Start with a Library, Not One-Off Purchases",[14,500,501,502,505],{},"Instead of buying components one at a time as you hit each need, start with a ",[18,503,504],{},"component library"," (like FramerHub's bundles) to get a broad toolkit at once — it's almost always cheaper per-component and means you're not searching mid-project for a specific piece.",[34,507,509],{"id":508},"a-real-example-adding-a-cms-connected-gallery","A Real Example: Adding a CMS-Connected Gallery",[14,511,512],{},"To make this concrete, here's what installing a real CMS-connected component looks like end to end, using a gallery component as the example.",[211,514,515,524,530,536,542,548],{},[50,516,517,520,521,248],{},[18,518,519],{},"Install the component"," via its URL, following Steps 1-2 above. It appears in the Assets panel as ",[200,522,523],{},"Gallery Kit / CMS Gallery",[50,525,526,529],{},[18,527,528],{},"Drag it onto a page"," where you want the gallery — typically a portfolio or case-studies page.",[50,531,532,535],{},[18,533,534],{},"Open the Properties Panel"," and look for a \"Collection\" dropdown. Select the CMS collection you want to display (e.g., \"Projects\").",[50,537,538,541],{},[18,539,540],{},"Map the fields."," Most gallery components ask you to map the collection's image field, title field, and optionally a category field for filtering. This takes 30 seconds if your CMS fields are already named sensibly.",[50,543,544,547],{},[18,545,546],{},"Choose a layout variant"," — masonry, grid, or carousel are common options exposed directly in the Properties Panel.",[50,549,550,553],{},[18,551,552],{},"Preview and adjust spacing/sizing"," for your specific page width, then publish.",[14,555,556],{},"Building the equivalent from scratch — a responsive masonry layout with a lightbox, connected dynamically to a CMS collection — would typically take an experienced Framer developer several hours. Installing a tested one takes minutes, and you inherit browser and accessibility testing you didn't have to do yourself.",[34,558,560,561,564],{"id":559},"when-not-to-use-a-code-component","When ",[23,562,563],{},"Not"," to Use a Code Component",[14,566,567],{},"Code components solve real problems, but they're not always the right tool. Reach for a native Framer layer instead when:",[47,569,570,576,582],{},[50,571,572,575],{},[18,573,574],{},"The interaction is genuinely simple"," — a basic hover color change or a fade-in on scroll doesn't need a code component; Framer's native Hover/Tap variants and Scroll Transform handle it with zero added weight.",[50,577,578,581],{},[18,579,580],{},"You need pixel-perfect control over a one-off layout"," that won't repeat elsewhere — a component's abstraction can get in the way when you need to hand-tune something unique to a single page.",[50,583,584,587],{},[18,585,586],{},"Performance is already tight"," and the component would add meaningful weight for a marginal visual improvement — weigh the interaction's value against its cost on a page that's already near your performance budget.",[14,589,590],{},"The rule of thumb: reach for a code component when you need real logic or a proven, reusable pattern. Reach for native layers when the interaction is simple enough that a component would be over-engineering it.",[34,592,594],{"id":593},"where-to-find-high-quality-framer-code-components","Where to Find High-Quality Framer Code Components",[14,596,597],{},"Not all components are built to the same standard. Before installing one, check for:",[47,599,600,607,613,619],{},[50,601,602,603,606],{},"✅ ",[18,604,605],{},"Performance-tested"," — loads fast, doesn't introduce jank on scroll.",[50,608,602,609,612],{},[18,610,611],{},"Well-documented"," — clear instructions and labeled property controls, not cryptic abbreviations.",[50,614,602,615,618],{},[18,616,617],{},"Regularly updated"," — bug fixes and ongoing compatibility with new Framer releases.",[50,620,602,621,624],{},[18,622,623],{},"Real support"," — a way to reach the developer directly if something breaks.",[14,626,627,630,631,634],{},[361,628,186],{"href":629},"/plugins/framer-components"," offers a curated library of premium components built specifically for ",[18,632,633],{},"Framer freelancers and agencies",". Every component is tested, optimized, and ready for client work out of the box.",[34,636,638],{"id":637},"conclusion","Conclusion",[14,640,641,642,645],{},"Adding ",[18,643,644],{},"code components to Framer"," is one of the fastest ways to level up a project without writing a single line of code yourself.",[14,647,648],{},"Instead of spending hours building a custom interaction from scratch, you get a battle-tested component running in minutes — and your clients get a more polished, more interactive site as a result.",[14,650,651],{},[18,652,653],{},"Next steps:",[211,655,656,669,672],{},[50,657,658,659,663,664,668],{},"Browse the ",[361,660,662],{"href":661},"/components","FramerHub component library",". Starting from a category, such as ",[361,665,667],{"href":666},"/components/category/backgrounds","animated backgrounds",", narrows the choice quickly.",[50,670,671],{},"Pick a component that solves a real pain point in your current build.",[50,673,674],{},"Install it, connect any CMS fields it needs, and see how much build time it saves you.",[14,676,677,678,681],{},"Ready to build faster? ",[361,679,680],{"href":661},"Explore FramerHub Components →"," and see for yourself how much time a tested library saves on your very next client project.",{"title":202,"searchDepth":683,"depth":683,"links":684},2,[685,686,692,693,699,700,701,707,713,714,716,717],{"id":36,"depth":683,"text":37},{"id":71,"depth":683,"text":72,"children":687},[688,690,691],{"id":79,"depth":689,"text":80},3,{"id":86,"depth":689,"text":87},{"id":93,"depth":689,"text":94},{"id":100,"depth":683,"text":101},{"id":175,"depth":683,"text":176,"children":694},[695,696,697,698],{"id":179,"depth":689,"text":180},{"id":208,"depth":689,"text":209},{"id":258,"depth":689,"text":259},{"id":282,"depth":689,"text":283},{"id":331,"depth":683,"text":332},{"id":380,"depth":683,"text":381},{"id":407,"depth":683,"text":408,"children":702},[703,704,705,706],{"id":411,"depth":689,"text":412},{"id":421,"depth":689,"text":422},{"id":430,"depth":689,"text":431},{"id":442,"depth":689,"text":443},{"id":455,"depth":683,"text":456,"children":708},[709,710,711,712],{"id":459,"depth":689,"text":460},{"id":470,"depth":689,"text":471},{"id":486,"depth":689,"text":487},{"id":497,"depth":689,"text":498},{"id":508,"depth":683,"text":509},{"id":559,"depth":683,"text":715},"When Not to Use a Code Component",{"id":593,"depth":683,"text":594},{"id":637,"depth":683,"text":638},"Tutorials","Learn how to install and customize Framer code components in minutes. A beginner-friendly guide to adding advanced functionality without writing code.","md",true,"/framerhub/img/blog/getting-started.webp",{"metaTitle":724,"metaDescription":725,"primaryKeyword":726,"secondaryKeywords":727,"heroImage":722,"ogImage":722,"schema":731,"createdAt":734},"How to Add Code Components to Framer | FramerHub","A complete beginner's guide to Framer code components — how to install, customize, and troubleshoot them without writing a single line of code yourself.","framer code components",[728,729,730],"add code components to framer","framer code component tutorial","framer code override",[732,736],{"type":733,"headline":5,"datePublished":734,"dateModified":735},"Article","2026-01-16","2026-07-06",{"type":737,"questions":738},"FAQPage",[739,742,745,748,751],{"question":740,"answer":741},"Do I need to know React to use Framer code components?","No. Code components are built by developers but designed for designers — you customize them entirely through the Properties Panel, the same way you'd style a regular frame. Knowing React only matters if you want to edit the underlying code yourself.",{"question":743,"answer":744},"Can I edit the code inside a Framer code component?","Yes, if you want to. Select the component instance and choose 'Unlink' (or open it as a code file) to edit the React/TypeScript source directly. Most users never need to — the exposed property controls cover the vast majority of customization needs.",{"question":746,"answer":747},"Will code components slow down my Framer site?","Not if they're built well. High-quality components are optimized for performance — using memoization, lazy-loading where appropriate, and minimal bundle size. Poorly built components (heavy unoptimized loops, unnecessary re-renders) can add lag, which is why sourcing components from a tested library matters.",{"question":749,"answer":750},"Can I use code components with Framer's CMS?","Absolutely. Many components are purpose-built for CMS integration — filterable galleries, dynamic cards, CMS-connected carousels. You connect a CMS collection to the component's properties the same way you'd connect it to a native Framer element.",{"question":752,"answer":753},"Where do I find the component URL to install a code component?","After purchasing or downloading a component from a marketplace like FramerHub, you'll receive a URL in the format https://framer.com/m/ComponentName-XyZ1.js. Paste this into Framer's Code Component insertion dialog (Cmd/Ctrl + K → Code Component) to add it to your project's Assets panel.","/blog/getting-started-framer-components","2026-01-16T00:00:00.000Z",9,null,{"title":5,"description":719},"getting-started-framer-components","blog/getting-started-framer-components",[762,763,764,765,766],"Framer","Tutorial","Beginner","Components","Code Components","2026-07-06T00:00:00.000Z","k-elLLcksHBgYEzxJbfm9ppZOXJPFCqXJzZ04LFjgJQ",[770,1513,2280],{"id":771,"title":772,"author":773,"body":774,"category":718,"description":1476,"extension":720,"featured":1477,"image":1478,"meta":1479,"navigation":721,"path":1504,"published":721,"publishedAt":1505,"readingTime":1506,"robots":757,"seo":1507,"slug":1508,"stem":1509,"tags":1510,"updatedAt":1505,"__hash__":1512},"blog/blog/framer-cms-collections-tutorial.md","Framer CMS Collections: The Complete Tutorial",{"name":7,"avatar":8,"bio":9},{"type":11,"value":775,"toc":1462},[776,779,782,785,789,792,795,798,800,804,841,844,846,850,853,856,876,880,1065,1079,1082,1088,1094,1096,1100,1103,1221,1224,1230,1240,1246,1248,1252,1255,1278,1284,1286,1290,1293,1317,1320,1322,1326,1329,1332,1340,1343,1346,1348,1352,1358,1364,1370,1376,1382,1388,1390,1394,1397,1415,1422,1426,1432,1438,1444,1450,1456],[14,777,778],{},"CMS collections are the feature that turns Framer from a static site builder into something that can power a blog, a product catalog, or a directory. If you've only built static pages so far, this is the tutorial that walks through Framer CMS collections from zero: creating one, structuring it so it survives a real project, and generating live pages from it.",[14,780,781],{},"The field structure is where the real work sits. Creating a collection takes about thirty seconds. Choosing the right fields is what decides whether you're still happily adding content in three weeks or quietly rebuilding the whole thing. Both are covered here, in the order you'll actually do them.",[783,784],"hr",{},[34,786,788],{"id":787},"what-a-collection-actually-is","What a Collection Actually Is",[14,790,791],{},"A CMS collection is a structured set of items. Think of it like a spreadsheet: each row is an item (a blog post, a product, a listing), and each column is a field (title, date, image, category).",[14,793,794],{},"The template is what makes it work. You design one page template for the collection, and Framer generates a live page for every item using that template. Add a new blog post to the collection and it gets its own published page without you building anything new.",[14,796,797],{},"That's the whole trade. You give up per-page design freedom for every item, and in return you get structure, consistency, and content you can add without opening the design canvas. It's the right trade for anything repeating and the wrong trade for a one-off page, which is why an About page stays a normal page and a blog post becomes a collection item.",[783,799],{},[34,801,803],{"id":802},"step-1-create-the-collection","Step 1: Create the Collection",[211,805,806,813,816,838],{},[50,807,808,809,812],{},"Open the ",[18,810,811],{},"CMS"," panel from the left sidebar of your Framer project.",[50,814,815],{},"Create a new collection. Framer lets you start from an empty collection, import a CSV, or start from its sample blog structure. The sample is genuinely useful for a first look, but delete its fields before building for real, they're an example, not a recommendation.",[50,817,818,819,822,823,822,826,829,830,833,834,837],{},"Name it with a plural noun that says what the items are: ",[200,820,821],{},"Blog Posts",", ",[200,824,825],{},"Properties",[200,827,828],{},"Job Listings",". Not ",[200,831,832],{},"Items",", not ",[200,835,836],{},"Content",". That name follows you into the design panel and into the URL structure for the pages Framer generates, so a vague name gets expensive.",[50,839,840],{},"Framer starts you with a few default fields. Leave them for now; step 2 replaces them.",[14,842,843],{},"If you're importing a CSV, still do step 2 before you import. Framer maps CSV columns onto fields, and it is much easier to fix the field structure while the collection is empty.",[783,845],{},[34,847,849],{"id":848},"step-2-structure-your-fields","Step 2: Structure Your Fields",[14,851,852],{},"Field structure decides how well the rest of the project goes, so give it more planning time than it usually gets.",[14,854,855],{},"Before you add a single field:",[47,857,858,864,870],{},[50,859,860,863],{},[18,861,862],{},"List every piece of content each item actually needs, from real examples."," Pull up three to five real blog posts or products and write down every distinct piece of information they carry. This catches the fields you'd otherwise discover mid-build, after the template is already designed around the fields you did remember.",[50,865,866,869],{},[18,867,868],{},"Choose the right field type for each piece of content."," A category should be an option field or a reference, not free text, which invites three spellings of \"Design\" across ten items. A publish date should be a Date field, not Text, which breaks sorting silently. A price should be a Number, not Text, or you lose the ability to sort or range-filter on it later.",[50,871,872,875],{},[18,873,874],{},"Mark fields required only when they truly are."," Over-strict required fields make early content entry miserable for no benefit. Too loose, and you end up with half-filled items that break the template.",[77,877,879],{"id":878},"framer-cms-field-types","Framer CMS field types",[106,881,882,895],{},[109,883,884],{},[112,885,886,889,892],{},[115,887,888],{},"Field type",[115,890,891],{},"What it stores",[115,893,894],{},"Best used for",[125,896,897,909,922,935,948,961,974,987,1000,1013,1026,1039,1052],{},[112,898,899,903,906],{},[130,900,901],{},[18,902,306],{},[130,904,905],{},"Short strings",[130,907,908],{},"Titles, names, labels",[112,910,911,916,919],{},[130,912,913],{},[18,914,915],{},"Rich Text",[130,917,918],{},"Formatted content",[130,920,921],{},"Blog body, long descriptions",[112,923,924,929,932],{},[130,925,926],{},[18,927,928],{},"Image",[130,930,931],{},"Image file",[130,933,934],{},"Cover photos, avatars, thumbnails",[112,936,937,942,945],{},[130,938,939],{},[18,940,941],{},"URL",[130,943,944],{},"Web address",[130,946,947],{},"External links, social profiles",[112,949,950,955,958],{},[130,951,952],{},[18,953,954],{},"Date",[130,956,957],{},"Date/time value",[130,959,960],{},"Publish dates, event dates",[112,962,963,968,971],{},[130,964,965],{},[18,966,967],{},"Number",[130,969,970],{},"Integer or decimal",[130,972,973],{},"Prices, ratings, counts, bedrooms",[112,975,976,981,984],{},[130,977,978],{},[18,979,980],{},"Boolean",[130,982,983],{},"True/false toggle",[130,985,986],{},"Featured flag, active status",[112,988,989,994,997],{},[130,990,991],{},[18,992,993],{},"Option",[130,995,996],{},"One value from a fixed list",[130,998,999],{},"Category, status, property type",[112,1001,1002,1007,1010],{},[130,1003,1004],{},[18,1005,1006],{},"Color",[130,1008,1009],{},"Hex/RGB value",[130,1011,1012],{},"Category color coding",[112,1014,1015,1020,1023],{},[130,1016,1017],{},[18,1018,1019],{},"File",[130,1021,1022],{},"Downloadable file",[130,1024,1025],{},"PDFs, spec sheets",[112,1027,1028,1033,1036],{},[130,1029,1030],{},[18,1031,1032],{},"Reference",[130,1034,1035],{},"A link to one item in another collection",[130,1037,1038],{},"Author on a blog post",[112,1040,1041,1046,1049],{},[130,1042,1043],{},[18,1044,1045],{},"Multi-reference",[130,1047,1048],{},"Links to several items in another collection",[130,1050,1051],{},"Tags on a blog post",[112,1053,1054,1059,1062],{},[130,1055,1056],{},[18,1057,1058],{},"Gallery",[130,1060,1061],{},"An array of images in one field",[130,1063,1064],{},"Property photos, product shots",[14,1066,1067,1068,1071,1072,1078],{},"One hard limit worth knowing before you plan the structure: Framer documents a cap of ",[18,1069,1070],{},"30 custom fields per collection"," (",[361,1073,1077],{"href":1074,"rel":1075},"https://www.framer.com/developers/cms",[1076],"nofollow","Framer developer docs","). That is generous for a blog and tight for a listings collection that tries to hold every specification as its own field, so spend the budget deliberately.",[14,1080,1081],{},"Two rules that save the most rework:",[14,1083,1084,1087],{},[18,1085,1086],{},"Use Number for anything you might ever filter or sort by a range."," Price, bedrooms, square footage, duration, rating. A number stored as Text can be displayed but not compared, and converting the field type after fifty items are entered means re-entering fifty items.",[14,1089,1090,1093],{},[18,1091,1092],{},"Use Option, not Text, for anything that repeats from a fixed list."," Status, category, property type. An Option field gives content editors a dropdown instead of a blank box, and it's what a filter UI binds to cleanly.",[783,1095],{},[34,1097,1099],{"id":1098},"a-worked-example-blog-collection-field-structure","A Worked Example: Blog Collection Field Structure",[14,1101,1102],{},"Here's the field structure we'd actually ship for a blog collection, which is the most common first collection people build. This is the version after a few projects, including the fields that got added later because something broke without them.",[106,1104,1105,1118],{},[109,1106,1107],{},[112,1108,1109,1112,1115],{},[115,1110,1111],{},"Field",[115,1113,1114],{},"Type",[115,1116,1117],{},"Why it exists",[125,1119,1120,1130,1140,1150,1160,1170,1180,1191,1201,1211],{},[112,1121,1122,1125,1127],{},[130,1123,1124],{},"Title",[130,1126,306],{},[130,1128,1129],{},"Required. Drives the H1 and the card title",[112,1131,1132,1135,1137],{},[130,1133,1134],{},"Slug",[130,1136,306],{},[130,1138,1139],{},"Auto-generated from the title; edit it before publishing, never after",[112,1141,1142,1145,1147],{},[130,1143,1144],{},"Publish Date",[130,1146,954],{},[130,1148,1149],{},"Required. Sorting depends on it, and so does anything date-stamped in the layout",[112,1151,1152,1155,1157],{},[130,1153,1154],{},"Featured Image",[130,1156,928],{},[130,1158,1159],{},"Used for the card, the detail hero, and the social preview",[112,1161,1162,1165,1167],{},[130,1163,1164],{},"Excerpt",[130,1166,306],{},[130,1168,1169],{},"Short summary for card and list views, written by hand",[112,1171,1172,1175,1177],{},[130,1173,1174],{},"Body",[130,1176,915],{},[130,1178,1179],{},"The article itself",[112,1181,1182,1185,1188],{},[130,1183,1184],{},"Category",[130,1186,1187],{},"Option or Reference",[130,1189,1190],{},"Option if it's a simple label; Reference if categories need their own pages and metadata",[112,1192,1193,1196,1198],{},[130,1194,1195],{},"Author",[130,1197,1032],{},[130,1199,1200],{},"Points to an Authors collection. Skip it entirely if there's only ever one writer",[112,1202,1203,1206,1208],{},[130,1204,1205],{},"Featured",[130,1207,980],{},[130,1209,1210],{},"Flags posts for a homepage or hero slot",[112,1212,1213,1216,1218],{},[130,1214,1215],{},"Reading Time",[130,1217,967],{},[130,1219,1220],{},"Added later. A rich text field can't tell you its own length at design time",[14,1222,1223],{},"Three decisions in that table are worth explaining, because they're the ones that get made wrong:",[14,1225,1226,1229],{},[18,1227,1228],{},"Excerpt and Body are separate fields, not one field truncated."," Truncating rich text for a card cuts mid-formatting and looks broken about a third of the time. A purpose-written excerpt gives you full control over what shows in a list view, and it's usually better copy than the first two lines of the article.",[14,1231,1232,1235,1236,1239],{},[18,1233,1234],{},"Category is Option or Reference, decided by whether categories need their own pages."," If you want ",[200,1237,1238],{},"/blog/category/design"," to exist as a real page with a description and its own listing, category has to be a Reference to a Categories collection. If you only ever show a label on a card, an Option field is simpler and one collection lighter.",[14,1241,1242,1245],{},[18,1243,1244],{},"Author is a Reference, and it's optional."," On a single-author blog, an Author reference is pure overhead, you'll type the same name into every item and design a byline that never changes. On a multi-author blog it's essential, because a bio update should happen once.",[783,1247],{},[34,1249,1251],{"id":1250},"step-3-build-the-collection-page-template","Step 3: Build the Collection Page Template",[14,1253,1254],{},"Once the fields exist, design the page template that every item will use.",[211,1256,1257,1260,1263,1269,1275],{},[50,1258,1259],{},"Create the collection's page template from the CMS panel. Framer handles the connection between the template and the collection.",[50,1261,1262],{},"Drag fields onto the page the way you'd place any content. A Title field becomes a heading, an Image field becomes an image element, a Rich Text field becomes the body. Framer binds them to live data automatically.",[50,1264,1265,1268],{},[18,1266,1267],{},"Design for your most content-heavy realistic item, not your shortest."," If the longest description you'll ever publish is three paragraphs, build the layout for three paragraphs, then check how it degrades on a short one. A layout built for a long item handles a short one gracefully. The reverse almost never holds.",[50,1270,1271,1274],{},[18,1272,1273],{},"Preview several real items before calling it done."," The template that looks perfect on the item you were staring at while designing will break on the one with a 90-character title or a missing optional image.",[50,1276,1277],{},"Set the page's SEO title and description from fields rather than hardcoding them, so every generated page gets its own metadata instead of the same string repeated across the site.",[14,1279,1280,1281,1283],{},"A component library speeds this up. Pre-built card and detail-page patterns from a ",[361,1282,504],{"href":661}," give you a starting point that already handles the long-title and missing-image cases, instead of discovering them yourself on a blank canvas.",[783,1285],{},[34,1287,1289],{"id":1288},"step-4-add-a-collection-list-to-a-parent-page","Step 4: Add a Collection List to a Parent Page",[14,1291,1292],{},"The template handles individual item pages. Visitors also need a way to find them, which means a list or grid on a parent page: a blog index, a product catalog, a listings page.",[211,1294,1295,1302,1305,1308,1311,1314],{},[50,1296,1297,1298,1301],{},"Add a ",[18,1299,1300],{},"Collection List"," element to your index page.",[50,1303,1304],{},"Connect it to your collection.",[50,1306,1307],{},"Design the card layout. This is usually a reduced version of the detail page, image, title, excerpt, date, showing just enough to earn the click.",[50,1309,1310],{},"Set the sort order deliberately. Newest-first is the right default for a blog and the wrong one for a product catalog.",[50,1312,1313],{},"Set an item limit and add pagination if the collection will grow past what one page load should carry.",[50,1315,1316],{},"Add native Dynamic Filters if readers need to narrow the list. Bind a filter to an Option field like Category and the list reacts, no plugin required.",[14,1318,1319],{},"Native filtering is real and it's free. A single category dropdown or a set of tabs over one field is exactly what native Dynamic Filters are for, and reaching for anything heavier at this stage is over-engineering.",[783,1321],{},[34,1323,1325],{"id":1324},"step-5-cross-collection-references","Step 5: Cross-Collection References",[14,1327,1328],{},"If your content model has real relationships, a post referencing an author, a product referencing a category, use Reference fields instead of duplicating the information as text in every item.",[14,1330,1331],{},"The payoff is maintenance. Update an author's bio once in the Authors collection and it updates everywhere that author is referenced, instead of hunting down every post where the name and title were typed by hand.",[14,1333,1334,1336,1337,1339],{},[18,1335,1032],{}," links one item to one item in another collection: a post to its author. ",[18,1338,1045],{}," links one item to several: a post to its tags. On the canvas, a Reference gives you one set of fields to place, while a multi-reference gives you a list you loop over.",[14,1341,1342],{},"Framer also supports adding a reference to a different collection from within a CMS detail page, which is how patterns like \"related posts\" or a link from a product to its parent category page get built without that relationship having to be the primary structure of either collection.",[14,1344,1345],{},"The rule we use: create a second collection when the referenced thing needs its own page or its own fields. An author needs a bio, a photo, and an archive page, so Authors is a collection. A status label like \"Draft\" or \"Live\" needs neither, so it stays an Option field.",[783,1347],{},[34,1349,1351],{"id":1350},"common-mistakes-when-setting-up-collections","Common Mistakes When Setting Up Collections",[14,1353,1354,1357],{},[18,1355,1356],{},"Building the template before finalizing the fields."," Changing the field structure after the template is designed means redoing layout work. Nail down fields first, even if the start feels slower.",[14,1359,1360,1363],{},[18,1361,1362],{},"One collection serving two very different content types."," If half your items are long articles and half are short announcements needing a different layout, that's two collections, not one collection carrying a pile of conditional visibility.",[14,1365,1366,1369],{},[18,1367,1368],{},"No plan for empty optional fields."," Design the template to survive a missing image or a blank secondary field. Whoever adds content in six months will leave optional fields blank, and they're right to.",[14,1371,1372,1375],{},[18,1373,1374],{},"Using Text where Number or Option belongs."," This is the one that costs the most later, because it blocks sorting and range filtering and can only be fixed by re-entering data.",[14,1377,1378,1381],{},[18,1379,1380],{},"Editing slugs after publishing."," Framer generates the item's URL from the slug. Changing it after the page is indexed breaks the link unless you add a redirect.",[14,1383,1384,1387],{},[18,1385,1386],{},"Skipping the extreme test item."," Add one item with an absurdly long title and one with the bare minimum filled in before you consider the collection done. That's where layout breakage actually gets found.",[783,1389],{},[34,1391,1393],{"id":1392},"beyond-collections-when-native-browsing-isnt-enough","Beyond Collections: When Native Browsing Isn't Enough",[14,1395,1396],{},"Collections plus native Dynamic Filters cover content structure and straightforward browsing well, and for most sites that's the end of the story.",[14,1398,1399,1400,1404,1405,1409,1410,1414],{},"Where they stop is advanced browsing on a collection with real scale. Native filtering has no multi-field search across several fields at once, no numeric or price range filtering, no facet counts next to each option, and no result count. If you're building a directory, a real estate listing site, or a job board on top of the structure in this tutorial, that's the wall, and ",[361,1401,1403],{"href":1402},"/plugins/framer-cms-filter","CMS Filter"," is our plugin for exactly that gap, with multi-field search, range filters, facets with counts, sorting, and a shareable filtered URL. For where native filtering ends in detail, see our ",[361,1406,1408],{"href":1407},"/blog/framer-dynamic-filters-guide","Dynamic Filters guide",". For the rest of the CMS surface beyond collections themselves, the ",[361,1411,1413],{"href":1412},"/blog/framer-cms-complete-guide","complete Framer CMS guide"," covers it.",[1416,1417],"blog-cta",{"button-link":1402,"button-text":1418,"description":1419,"title":1420,"variant":1421},"See CMS Filter","CMS Filter adds multi-field search, range filters, facets with counts and a shareable filtered URL to any Framer collection.","Collections done. Filtering next?","blue",[34,1423,1425],{"id":1424},"faq","FAQ",[14,1427,1428,1431],{},[18,1429,1430],{},"What's the difference between a CMS collection and a page in Framer?","\nA page is a single, unique piece of your site. A collection is a set of structured items (blog posts, products, listings) that each generate their own page automatically from one shared template, you design the template once, and it applies to every item.",[14,1433,1434,1437],{},[18,1435,1436],{},"How do I create a collection in Framer?","\nOpen the CMS panel in the left sidebar and create a new collection. You can start empty, import a CSV, or start from Framer's sample blog structure. Name it with a plural noun, then replace the default fields with the field structure your content actually needs before you design anything.",[14,1439,1440,1443],{},[18,1441,1442],{},"Can one CMS detail page reference a different collection?","\nYes, Framer supports adding a reference to another collection from within a CMS detail page, useful for related content patterns like \"related posts\" or a product's category page.",[14,1445,1446,1449],{},[18,1447,1448],{},"How many fields should a collection have?","\nAs many as the content genuinely needs, and no more. Every additional field is something a content editor has to fill in and something you have to design for, unused optional fields add maintenance overhead without adding value.",[14,1451,1452,1455],{},[18,1453,1454],{},"Can I use one collection for pages with different layouts?","\nNot directly, a single collection uses one shared template. If you need meaningfully different layouts for different content types, you generally want separate collections, or a field that conditionally shows/hides sections within one shared template.",[14,1457,1458,1461],{},[18,1459,1460],{},"When do I need a plugin instead of just native collections?","\nWhen you need capabilities collections don't natively support well, multi-field search, price or date range filtering, facet counts, or a shareable filtered URL across many items. Native collections handle the data structure and basic filtering; a plugin like CMS Filter handles advanced browsing behavior on top of it.",{"title":202,"searchDepth":683,"depth":683,"links":1463},[1464,1465,1466,1469,1470,1471,1472,1473,1474,1475],{"id":787,"depth":683,"text":788},{"id":802,"depth":683,"text":803},{"id":848,"depth":683,"text":849,"children":1467},[1468],{"id":878,"depth":689,"text":879},{"id":1098,"depth":683,"text":1099},{"id":1250,"depth":683,"text":1251},{"id":1288,"depth":683,"text":1289},{"id":1324,"depth":683,"text":1325},{"id":1350,"depth":683,"text":1351},{"id":1392,"depth":683,"text":1393},{"id":1424,"depth":683,"text":1425},"A hands-on tutorial for Framer CMS collections: creating one, structuring fields, connecting a page template, and generating dynamic pages from scratch.",false,"/framerhub/img/blog/framer-cms-collections-tutorial.webp",{"metaTitle":1480,"metaDescription":1476,"primaryKeyword":1481,"secondaryKeywords":1482,"heroImage":1478,"ogImage":1478,"schema":1487,"createdAt":735},"Framer CMS Collections: The Complete Tutorial | FramerHub","framer cms collections",[1483,1484,1485,1486],"framer cms collections documentation","how to create a collection in framer","framer collection page template","framer reference field",[1488,1490],{"type":733,"headline":772,"datePublished":1489,"dateModified":1489},"2026-10-23",{"type":737,"questions":1491},[1492,1494,1496,1498,1500,1502],{"question":1430,"answer":1493},"A page is a single, unique piece of your site. A collection is a set of structured items (blog posts, products, listings) that each generate their own page automatically from one shared template, you design the template once, and it applies to every item.",{"question":1436,"answer":1495},"Open the CMS panel in the left sidebar and create a new collection. You can start empty, import a CSV, or start from Framer's sample blog structure. Name it with a plural noun, then replace the default fields with the field structure your content actually needs before you design anything.",{"question":1442,"answer":1497},"Yes, Framer supports adding a reference to another collection from within a CMS detail page, useful for related content patterns like 'related posts' or a product's category page.",{"question":1448,"answer":1499},"As many as the content genuinely needs, and no more. Every additional field is something a content editor has to fill in and something you have to design for, unused optional fields add maintenance overhead without adding value.",{"question":1454,"answer":1501},"Not directly, a single collection uses one shared template. If you need meaningfully different layouts for different content types, you generally want separate collections, or a field that conditionally shows/hides sections within one shared template.",{"question":1460,"answer":1503},"When you need capabilities collections don't natively support well, multi-field search, price or date range filtering, facet counts, or a shareable filtered URL across many items. Native collections handle the data structure and basic filtering; a plugin like CMS Filter handles advanced browsing behavior on top of it.","/blog/framer-cms-collections-tutorial","2026-10-23T00:00:00.000Z",11,{"title":772,"description":1476},"framer-cms-collections-tutorial","blog/framer-cms-collections-tutorial",[762,811,1511],"Collections","jn3lQUS7dhAapj4W66zcUhO95y46-u0_7CRRtNe1XE8",{"id":1514,"title":1515,"author":1516,"body":1517,"category":718,"description":2253,"extension":720,"featured":1477,"image":2254,"meta":2255,"navigation":721,"path":2272,"published":721,"publishedAt":1505,"readingTime":2273,"robots":757,"seo":2274,"slug":2275,"stem":2276,"tags":2277,"updatedAt":1505,"__hash__":2279},"blog/blog/framer-real-estate-website-guide.md","How to Build a Real Estate Website in Framer",{"name":7,"avatar":8,"bio":9},{"type":11,"value":1518,"toc":2230},[1519,1522,1531,1533,1537,1540,1710,1713,1719,1725,1727,1731,1734,1737,1739,1743,1746,1752,1762,1768,1774,1780,1785,1787,1791,1796,1802,1808,1814,1820,1826,1832,1838,1844,1850,1856,1862,1872,1878,1882,1954,1956,1960,1966,1972,1978,1988,1994,1996,2000,2003,2006,2009,2011,2015,2018,2024,2030,2036,2047,2055,2057,2061,2067,2073,2079,2085,2087,2091,2097,2103,2109,2115,2121,2125,2128,2131,2151,2154,2156,2158,2162,2165,2169,2172,2176,2179,2183,2186,2190,2193,2195,2199,2205,2214,2221,2225],[14,1520,1521],{},"Real estate buyers filter aggressively. Price range, bedrooms, location, property type, often all at once, before they'll look at a single listing photo. A framer real estate site that can't handle that loses visitors before they reach the properties that would have matched.",[14,1523,1524,1525,1530],{},"This guide covers the field structure property listings actually need, what native Framer filtering does and doesn't cover for this specific vertical, and how to add the price range and combined filters buyers expect. There's a live demo of the finished filtering behaviour at ",[361,1526,1529],{"href":1527,"target":1528},"https://framercmsfilter.com/demo?demo=real-estate","_blank","framercmsfilter.com/demo?demo=real-estate",", location, property type, price range and bedrooms working together, so you can see the end state before you build it.",[783,1532],{},[34,1534,1536],{"id":1535},"structuring-property-listings-in-framers-cms","Structuring property listings in Framer's CMS",[14,1538,1539],{},"Real estate listings need more structured fields than almost any other CMS use case, because buyers filter on nearly every data point. This is the schema we'd ship, the same shape of data you can see being filtered in the live demo.",[106,1541,1542,1553],{},[109,1543,1544],{},[112,1545,1546,1548,1550],{},[115,1547,1111],{},[115,1549,1114],{},[115,1551,1552],{},"Why it's this type",[125,1554,1555,1564,1576,1588,1598,1610,1622,1634,1646,1658,1668,1680,1690,1700],{},[112,1556,1557,1559,1561],{},[130,1558,1124],{},[130,1560,306],{},[130,1562,1563],{},"The listing headline (\"3-bed craftsman, Eastside\")",[112,1565,1566,1569,1573],{},[130,1567,1568],{},"Price",[130,1570,1571],{},[18,1572,967],{},[130,1574,1575],{},"A Text price can be displayed but never range-filtered or sorted",[112,1577,1578,1581,1585],{},[130,1579,1580],{},"City / Neighborhood",[130,1582,1583],{},[18,1584,993],{},[130,1586,1587],{},"A fixed list gives buyers a clean facet and stops \"Austin\" and \"austin \" becoming two values",[112,1589,1590,1593,1595],{},[130,1591,1592],{},"Full address",[130,1594,306],{},[130,1596,1597],{},"Display only, separate from the filterable location field",[112,1599,1600,1603,1607],{},[130,1601,1602],{},"Bedrooms",[130,1604,1605],{},[18,1606,967],{},[130,1608,1609],{},"Buyers filter \"3 or more\", which needs a numeric comparison",[112,1611,1612,1615,1619],{},[130,1613,1614],{},"Bathrooms",[130,1616,1617],{},[18,1618,967],{},[130,1620,1621],{},"Same reason, and half-baths mean it needs decimals",[112,1623,1624,1627,1631],{},[130,1625,1626],{},"Square footage",[130,1628,1629],{},[18,1630,967],{},[130,1632,1633],{},"Second most common range filter after price",[112,1635,1636,1639,1643],{},[130,1637,1638],{},"Property type",[130,1640,1641],{},[18,1642,993],{},[130,1644,1645],{},"House, condo, townhouse, land",[112,1647,1648,1651,1655],{},[130,1649,1650],{},"Status",[130,1652,1653],{},[18,1654,993],{},[130,1656,1657],{},"For sale, pending, sold — so unavailable stock can be filtered out without deleting the page",[112,1659,1660,1663,1665],{},[130,1661,1662],{},"Year built",[130,1664,967],{},[130,1666,1667],{},"Optional, but it's a range filter buyers use more than agents expect",[112,1669,1670,1673,1677],{},[130,1671,1672],{},"Listed date",[130,1674,1675],{},[18,1676,954],{},[130,1678,1679],{},"Powers \"new this week\" and newest-first sorting",[112,1681,1682,1684,1687],{},[130,1683,1058],{},[130,1685,1686],{},"Image (multiple)",[130,1688,1689],{},"Real estate is the most photo-dependent listing category there is",[112,1691,1692,1695,1697],{},[130,1693,1694],{},"Description",[130,1696,915],{},[130,1698,1699],{},"The write-up on the detail page",[112,1701,1702,1705,1707],{},[130,1703,1704],{},"Listing agent",[130,1706,1032],{},[130,1708,1709],{},"Points at an Agents collection, so a bio change happens once",[14,1711,1712],{},"The two decisions that cost the most if you get them wrong:",[14,1714,1715,1718],{},[18,1716,1717],{},"Location is two fields, not one."," A full address is for display. A City or Neighborhood Option field is what a filter binds to. Try to do both jobs with one text field and you'll end up with a filter dropdown containing forty unique addresses.",[14,1720,1721,1724],{},[18,1722,1723],{},"Price, beds, baths and square footage must be Number fields from day one."," Retrofitting the field type after eighty listings are entered as text means re-entering eighty listings. This is the single most common expensive mistake on a real estate build.",[783,1726],{},[34,1728,1730],{"id":1729},"building-the-native-listing-grid","Building the native listing grid",[14,1732,1733],{},"Drag a Collection List onto the page, connect it to the property collection, and design a card showing the hero image, price, city, and a bed/bath/sqft summary line. Add native Dynamic Filters bound to Property type and Status. That's a working, browsable listings page, and it's free.",[14,1735,1736],{},"For a single agent with twenty active listings, this is genuinely the right answer. Native filtering handles tabs, dropdowns, checkboxes and toggles bound to a field, it combines them with AND logic, and it drives URL parameters from the page variables behind each filter, so a filtered view is shareable. Don't reach past it until the project needs something it doesn't do.",[783,1738],{},[34,1740,1742],{"id":1741},"where-native-filtering-falls-short-for-real-estate-specifically","Where native filtering falls short for real estate specifically",[14,1744,1745],{},"Real estate is the vertical that hits the ceiling fastest, because the four things buyers filter on are exactly the four native filtering doesn't compose.",[14,1747,1748,1751],{},[18,1749,1750],{},"No price range."," Native filter controls bind a field to an option, a checkbox or a toggle. A $400k–$800k band needs a numeric range control, which isn't one of the native types.",[14,1753,1754,1757,1758,1761],{},[18,1755,1756],{},"No \"3 or more\" threshold on a numeric field."," Buyers almost never want exactly three bedrooms. Modelling \"3+\" as option values (\"1\", \"2\", \"3\", \"4+\") is the usual workaround, and it breaks the moment someone wants 3-or-more ",[23,1759,1760],{},"and"," under $700k.",[14,1763,1764,1767],{},[18,1765,1766],{},"No result count."," \"38 properties match\" is a real usability feature on a listings page, and it's the first thing a client asks for after seeing the first build.",[14,1769,1770,1773],{},[18,1771,1772],{},"No option counts on the facets."," Buyers scan \"Miami (12)\" and skip the empty neighborhoods. Without counts they click into dead ends.",[14,1775,1776,1779],{},[18,1777,1778],{},"No saved or favourited listings."," Buyers compare. A shortlist is standard behaviour on every portal they've used.",[14,1781,1782,1783,248],{},"For the full picture of what native Dynamic Filters cover and where they stop across any CMS use case, see our ",[361,1784,1408],{"href":1407},[783,1786],{},[34,1788,1790],{"id":1789},"adding-real-estate-grade-filtering-with-cms-filter","Adding real estate-grade filtering with CMS Filter",[14,1792,1793,1795],{},[361,1794,1403],{"href":1402}," is our plugin, and real estate is the use case it fits best, because every gap above is one of its components.",[14,1797,1798,1801],{},[18,1799,1800],{},"Price as a real range."," A range filter type bound to the Price number field, as a dual input or a slider, with unit formatting so buyers see $450,000 rather than 450000.",[14,1803,1804,1807],{},[18,1805,1806],{},"Bedrooms and bathrooms as thresholds."," Number filters ship with eight comparison operators, so \"3 or more bedrooms\" is a setting, not a workaround.",[14,1809,1810,1813],{},[18,1811,1812],{},"Location, property type and status composed with price and beds."," AND/OR logic is composed at three levels, per filter, per filter builder, and on the collection itself, so four filters narrowing at once behaves the way buyers expect.",[14,1815,1816,1819],{},[18,1817,1818],{},"A live result count."," A count component renders \"38 properties\" against the current filter state and updates as buyers narrow.",[14,1821,1822,1825],{},[18,1823,1824],{},"Facets with option counts."," Auto-detected from the CMS option fields, so \"Miami (12)\" comes for free once the field is an Option.",[14,1827,1828,1831],{},[18,1829,1830],{},"Removable filter chips."," A buyer four filters deep can drop the price range without resetting bedrooms and location.",[14,1833,1834,1837],{},[18,1835,1836],{},"Multi-field search."," One debounced input searching across title, address and description together, rather than one field at a time.",[14,1839,1840,1843],{},[18,1841,1842],{},"Listed-date range."," A date range toggle for \"new this week\", which is the single highest-engagement filter on most portals.",[14,1845,1846,1849],{},[18,1847,1848],{},"Sorting and pagination."," Sort by price or square footage, then page through results rather than rendering four hundred listings into one scroll.",[14,1851,1852,1855],{},[18,1853,1854],{},"Saved favourites."," A favourite button on the card and a saved-listings view, so buyers can build a shortlist.",[14,1857,1858,1861],{},[18,1859,1860],{},"Desktop sidebar and mobile drawer stay in sync."," Filter surfaces sharing a store key show the same state, so a buyer who filters in the mobile drawer sees it reflected everywhere.",[14,1863,1864,1867,1868,1871],{},[18,1865,1866],{},"Shareable filtered URLs."," One ",[200,1869,1870],{},"urlSync"," toggle on the collection writes the active filter state into the URL, so an agent can send a client a link to \"3-bed condos in Eastside under $700k\" and have it open filtered.",[14,1873,1874,1875,1877],{},"The live demo runs this exact combination: ",[361,1876,1529],{"href":1527,"target":1528},". Show it to the client before you quote the build, it's a faster conversation than a spec document.",[77,1879,1881],{"id":1880},"setup-steps","Setup steps",[211,1883,1884,1887,1897,1907,1913,1926,1936,1945],{},[50,1885,1886],{},"Install CMS Filter from the FramerHub plugin page or the Framer Marketplace.",[50,1888,1889,1890,1893,1894,248],{},"Replace the Collection List with ",[200,1891,1892],{},"CMSCollection",", connected to the property collection, and give it a ",[200,1895,1896],{},"storeKey",[50,1898,1899,1900,1903,1904,1906],{},"Add ",[200,1901,1902],{},"CMSFilters"," with the same ",[200,1905,1896],{},". Configure a range filter on Price, number filters with a \"greater than or equal\" operator on Bedrooms and Bathrooms, and option filters on City, Property type and Status.",[50,1908,1899,1909,1912],{},[200,1910,1911],{},"CMSSearch"," across Title, Full address and Description.",[50,1914,1899,1915,822,1918,1921,1922,1925],{},[200,1916,1917],{},"CMSCount",[200,1919,1920],{},"CMSFacets"," and ",[200,1923,1924],{},"CMSClearAll"," around the grid.",[50,1927,1899,1928,1931,1932,1935],{},[200,1929,1930],{},"CMSPagination"," under the grid and ",[200,1933,1934],{},"CMSSort"," above it.",[50,1937,1938,1939,1941,1942,1944],{},"For a desktop sidebar plus a mobile filter drawer, duplicate the ",[200,1940,1902],{}," block with the same ",[200,1943,1896],{}," so both surfaces stay synchronized.",[50,1946,1947,1948,1950,1951,1953],{},"Turn on ",[200,1949,1870],{}," on ",[200,1952,1892],{}," last, then test that a filtered URL opens in the same state in a fresh browser.",[783,1955],{},[34,1957,1959],{"id":1958},"design-details-that-matter-for-real-estate-buyers","Design details that matter for real estate buyers",[14,1961,1962,1965],{},[18,1963,1964],{},"Photo quality and gallery depth."," A gallery with lightbox viewing beats a single hero image by more here than anywhere else.",[14,1967,1968,1971],{},[18,1969,1970],{},"Map placement."," Buyers want location context immediately, either as a map toggle beside the grid or embedded on the detail page. If you show a map next to a filtered grid, keep it in sync with the filter state, a map showing every property while the list shows twelve is worse than no map.",[14,1973,1974,1977],{},[18,1975,1976],{},"Status visible on the card."," A buyer who falls for a sold listing and only finds out after clicking through has a bad experience that reflects on the agent.",[14,1979,1980,1983,1984,1987],{},[18,1981,1982],{},"Fast image-heavy pages."," Multiple high-resolution photos per listing plus a filterable grid is a naturally heavy page. Serve appropriately sized images and lazy-load below the fold; our ",[361,1985,1986],{"href":363},"performance guide"," covers the general approach.",[14,1989,1990,1993],{},[18,1991,1992],{},"Agent contact reachable from both places."," Contact details or an enquiry form should be one click away from the grid and from every property page.",[783,1995],{},[34,1997,1999],{"id":1998},"individual-property-detail-pages","Individual property detail pages",[14,2001,2002],{},"Each property needs its own page: the full gallery, complete specifications, the write-up, and a way to request a showing. Framer's CMS page templates generate one detail page per collection item from the same fields you set up for filtering, so this comes almost free once the schema is right.",[14,2004,2005],{},"Design the template for your most complete listing and check it against your thinnest one. A luxury listing with 40 photos and a 600-word description and a bare land listing with three photos and two lines have to survive the same layout.",[14,2007,2008],{},"Enquiry handling is where real estate sites leak leads. A generic \"thanks, we'll be in touch\" is weaker than confirming which agent will respond and roughly how soon. On a multi-agent site, route the enquiry using the listing agent reference field rather than dropping everything into a shared inbox.",[783,2010],{},[34,2012,2014],{"id":2013},"seo-for-real-estate-listing-pages","SEO for real estate listing pages",[14,2016,2017],{},"Real estate is a category where SEO drives genuinely high-intent traffic, because buyers search very specifically (\"3 bedroom house Austin under 500k\").",[14,2019,2020,2023],{},[18,2021,2022],{},"Give every property its own indexable detail page",", with a title and meta description built from its actual fields, address, price, bedrooms, not one template string repeated across 200 pages.",[14,2025,2026,2029],{},[18,2027,2028],{},"Use structured data"," appropriate to the listing type so price and key details can appear in the result before the click.",[14,2031,2032,2035],{},[18,2033,2034],{},"Handle sold listings deliberately."," Either redirect a sold listing to a relevant active page or keep it live with a clear sold status. Deleting pages that accumulated search value is the worst of the three options.",[14,2037,2038,2041,2042,2046],{},[18,2039,2040],{},"Build location landing pages if volume supports it."," A page for \"homes for sale in ",[2043,2044,2045],"span",{},"neighborhood","\" that links into a pre-filtered result set captures location intent the grid alone won't reach, and with URL sync on, that pre-filtered link is one you can actually create.",[14,2048,2049,2050,2054],{},"Our ",[361,2051,2053],{"href":2052},"/blog/framer-seo-guide","Framer SEO guide"," covers the site-level settings behind all of this.",[783,2056],{},[34,2058,2060],{"id":2059},"lead-capture-and-supporting-content","Lead capture and supporting content",[14,2062,2063,2066],{},[18,2064,2065],{},"Enquiry and showing-request forms"," are the conversion point on a real estate site. Validate them properly, a broken contact form on a $600k listing page is an expensive bug, not a cosmetic one, and confirm submissions are actually arriving before handover, not after.",[14,2068,2069,2072],{},[18,2070,2071],{},"A mortgage or affordability calculator"," helps buyers self-qualify before they reach out, and it's a common reason a listings site gets bookmarked.",[14,2074,2075,2078],{},[18,2076,2077],{},"Neighborhood and area guides"," support both SEO and the buyer's actual decision, and they're the content an agent can genuinely write.",[14,2080,2081,2082,248],{},"For the collection and reference-field mechanics underneath all of this, see the ",[361,2083,2084],{"href":1412},"Framer CMS complete guide",[783,2086],{},[34,2088,2090],{"id":2089},"common-real-estate-site-mistakes","Common real estate site mistakes",[14,2092,2093,2096],{},[18,2094,2095],{},"Text fields instead of Number fields for price, beds and square footage."," This blocks range and threshold filtering entirely and is usually discovered after data entry.",[14,2098,2099,2102],{},[18,2100,2101],{},"No status filter, so sold properties clutter active results."," Buyers filtering for available homes shouldn't have to click through sold ones.",[14,2104,2105,2108],{},[18,2106,2107],{},"A single low-resolution hero image instead of a real gallery."," This undersells every listing on the site.",[14,2110,2111,2114],{},[18,2112,2113],{},"No mobile filter drawer."," A large share of property searching happens on a phone, often while driving through a neighborhood. Desktop-only filtering misses that entirely.",[14,2116,2117,2120],{},[18,2118,2119],{},"Promising an MLS feed before checking what it takes."," Every real estate client raises this one first.",[77,2122,2124],{"id":2123},"what-about-mlsidx-feeds","What about MLS/IDX feeds?",[14,2126,2127],{},"Be straight about this one, because it decides whether the project is a Framer build at all.",[14,2129,2130],{},"Framer's CMS has no MLS or IDX integration. There is no native connector, and nothing in the CMS pulls a feed on a schedule. That leaves three honest routes:",[211,2132,2133,2139,2145],{},[50,2134,2135,2138],{},[18,2136,2137],{},"Manual or CSV-based listings."," The agent or their assistant maintains listings in the Framer CMS, importing via CSV when there's a batch. This is the right answer for a single agent or a small boutique brokerage with their own inventory, and it's what most of these builds actually are.",[50,2140,2141,2144],{},[18,2142,2143],{},"A server-side job that writes into the CMS."," Something outside Framer reads the feed and writes items in through Framer's Server API. This is a real software project with real maintenance, not a plugin you install, budget it as one.",[50,2146,2147,2150],{},[18,2148,2149],{},"An embedded third-party IDX widget."," Fastest to ship, and it costs you design control: the listing pages come from the vendor's iframe, not your Framer template, so the filtering and detail design in this guide stop applying to those pages.",[14,2152,2153],{},"On top of the technical route, MLS display rules are set by each local board and association, and access is typically tied to a licensed member. Confirm what the client's board allows before you quote a feed-driven build. Telling a client \"not this way, here's what it would actually take\" early is much cheaper than discovering it in week three.",[783,2155],{},[34,2157,1425],{"id":1424},[77,2159,2161],{"id":2160},"can-framer-handle-a-real-estate-listings-website","Can Framer handle a real estate listings website?",[14,2163,2164],{},"Yes. Framer's CMS collections work well for property listings, with each property as a collection item holding price, location, bedrooms, square footage, and images. The part native Framer doesn't cover is a price range filter and several filters composed together with a live result count, both of which real estate sites need almost by default.",[77,2166,2168],{"id":2167},"how-do-i-add-a-price-range-slider-to-a-framer-real-estate-site","How do I add a price range slider to a Framer real estate site?",[14,2170,2171],{},"Framer's native Dynamic Filters cover tabs, dropdowns, checkboxes and toggles bound to a field, not a numeric range. The CMS Filter plugin adds a range filter type that binds to a numeric CMS field as a dual input or a slider, with unit formatting for prices.",[77,2173,2175],{"id":2174},"what-cms-fields-does-a-real-estate-website-need","What CMS fields does a real estate website need?",[14,2177,2178],{},"At minimum: price, city or neighborhood, bedrooms, bathrooms, square footage, property type, status, and images. Price, bedrooms, bathrooms and square footage must be Number fields, and city, property type and status should be Option fields, or you lose range and facet filtering later.",[77,2180,2182],{"id":2181},"can-a-framer-real-estate-site-pull-listings-from-an-mls-or-idx-feed","Can a Framer real estate site pull listings from an MLS or IDX feed?",[14,2184,2185],{},"Not natively. Framer's CMS has no MLS or IDX integration, so a feed has to reach the CMS some other way: a server-side job that writes items in through Framer's Server API, or an embedded third-party IDX widget, which costs you design control over the listing pages. MLS display rules are set by each local board, so confirm them before quoting the work.",[77,2187,2189],{"id":2188},"how-do-i-filter-properties-by-bedrooms-and-price-at-the-same-time-in-framer","How do I filter properties by bedrooms and price at the same time in Framer?",[14,2191,2192],{},"You need several filters composed together. Native Dynamic Filters combine with AND logic but have no numeric range control. CMS Filter composes a price range filter, a bedrooms threshold filter, and location and property type filters in one collection, with a result count and removable filter chips.",[783,2194],{},[34,2196,2198],{"id":2197},"bottom-line","Bottom line",[14,2200,2201,2202,2204],{},"A framer real estate site lives or dies on two things: number fields set correctly on day one, and filtering that composes price, bedrooms, location and property type at once. Native Framer gets you the CMS structure, the detail pages and a browsable grid, genuinely enough for a small single-agent site. Past that, the range filter, the result count and the shareable filtered URL are what buyers expect, and that's the gap ",[361,2203,1403],{"href":1402}," fills.",[14,2206,2207,2208,2213],{},"If you'd rather start from a finished design, we built ",[361,2209,2212],{"href":2210,"rel":2211,"target":1528},"https://www.framer.com/marketplace/templates/marren-co/",[1076],"Marren & Co",", a real estate template on the Framer Marketplace. Its listings page uses CMS Filter for search, filters and sorting, with grid, map and split views, and Form Kit powers the valuation and contact forms.",[14,2215,2216,2217,2220],{},"Look at the ",[361,2218,2219],{"href":1527,"target":1528},"real estate filtering demo"," before you scope the project. It's the fastest way to find out whether the client wants what you're about to quote.",[1416,2222],{"button-link":1402,"button-text":1418,"description":2223,"title":2224,"variant":1421},"Price ranges, bedroom thresholds, facet counts, saved favourites and shareable filtered URLs on any Framer CMS collection.","Filtering built for listings sites",[14,2226,2227],{},[23,2228,2229],{},"Last updated: October 2026",{"title":202,"searchDepth":683,"depth":683,"links":2231},[2232,2233,2234,2235,2238,2239,2240,2241,2242,2245,2252],{"id":1535,"depth":683,"text":1536},{"id":1729,"depth":683,"text":1730},{"id":1741,"depth":683,"text":1742},{"id":1789,"depth":683,"text":1790,"children":2236},[2237],{"id":1880,"depth":689,"text":1881},{"id":1958,"depth":683,"text":1959},{"id":1998,"depth":683,"text":1999},{"id":2013,"depth":683,"text":2014},{"id":2059,"depth":683,"text":2060},{"id":2089,"depth":683,"text":2090,"children":2243},[2244],{"id":2123,"depth":689,"text":2124},{"id":1424,"depth":683,"text":1425,"children":2246},[2247,2248,2249,2250,2251],{"id":2160,"depth":689,"text":2161},{"id":2167,"depth":689,"text":2168},{"id":2174,"depth":689,"text":2175},{"id":2181,"depth":689,"text":2182},{"id":2188,"depth":689,"text":2189},{"id":2197,"depth":683,"text":2198},"How to build a real estate website in Framer: structuring property listings in the CMS, adding price range sliders and multi-field filters, and the design details that matter for buyers.","/framerhub/img/blog/framer-real-estate-website-guide.webp",{"metaTitle":2256,"metaDescription":2257,"primaryKeyword":2258,"secondaryKeywords":2259,"heroImage":2254,"ogImage":2254,"schema":2263,"createdAt":735},"How to Build a Real Estate Website in Framer | FramerHub","Build a real estate website in Framer with CMS-driven listings, price range sliders, and multi-field filtering for bedrooms, location, and property type.","framer real estate",[2260,2261,2262],"framer real estate website","framer property listing","real estate website framer",[2264,2265],{"type":733,"headline":1515,"datePublished":1489,"dateModified":1489},{"type":737,"questions":2266},[2267,2268,2269,2270,2271],{"question":2161,"answer":2164},{"question":2168,"answer":2171},{"question":2175,"answer":2178},{"question":2182,"answer":2185},{"question":2189,"answer":2192},"/blog/framer-real-estate-website-guide",12,{"title":1515,"description":2253},"framer-real-estate-website-guide","blog/framer-real-estate-website-guide",[762,2278,1403,763],"Real Estate","NpLuGaSCH6obT7agEuTLPFYYayF_Znh7mTy2IaWRuB8",{"id":2281,"title":2282,"author":2283,"body":2284,"category":718,"description":2790,"extension":720,"featured":1477,"image":2791,"meta":2792,"navigation":721,"path":2819,"published":721,"publishedAt":2820,"readingTime":756,"robots":757,"seo":2821,"slug":2822,"stem":2823,"tags":2824,"updatedAt":2820,"__hash__":2825},"blog/blog/framer-cms-gallery-guide.md","Framer Gallery: How to Build a CMS Image Gallery (2026)",{"name":7,"avatar":8,"bio":9},{"type":11,"value":2285,"toc":2764},[2286,2289,2292,2317,2321,2324,2350,2353,2356,2360,2363,2366,2370,2373,2377,2380,2384,2387,2391,2394,2398,2404,2408,2412,2415,2501,2504,2508,2525,2530,2534,2614,2617,2621,2624,2650,2654,2660,2666,2672,2676,2708,2713,2715,2719,2722,2726,2729,2733,2736,2740,2743,2747,2750,2754,2757,2761],[14,2287,2288],{},"To build a gallery in Framer, put your images in a CMS collection, add a Collection List to the page and design one image card. That gives you a working grid in a few minutes. Framer doesn't do lightbox or masonry natively, so for a full-screen viewer, varied-height layouts or thumbnail sliders you add a gallery component connected to the same collection.",[14,2290,2291],{},"We build Framer components used by 2,000+ Framer users, including the CMS gallery components covered below, so this guide starts with what Framer does natively and only reaches for a component where native stops.",[2293,2294,2295,2300],"blockquote",{},[14,2296,2297],{},[18,2298,2299],{},"Key Takeaways",[47,2301,2302,2305,2308,2311,2314],{},[50,2303,2304],{},"A native Framer gallery is a CMS collection plus a Collection List; it's the right choice for small, uniform grids.",[50,2306,2307],{},"Framer has no native lightbox or masonry layout. Both need a component or hand-built overlay states.",[50,2309,2310],{},"Framer's built-in Slideshow and Carousel cover simple sliders; CMS-driven sliders with thumbnails need a dedicated component.",[50,2312,2313],{},"Pick the layout by content: masonry and lightbox for photography, uniform grid for products, slider for before/after work.",[50,2315,2316],{},"Galleries are the easiest pages to make slow: compress before upload and lazy-load below the fold.",[34,2318,2320],{"id":2319},"step-1-set-up-your-cms-collection","Step 1: Set up your CMS collection",[14,2322,2323],{},"Open the CMS panel and create a collection (or add fields to an existing one):",[47,2325,2326,2332,2338,2344],{},[50,2327,2328,2331],{},[18,2329,2330],{},"Image field",": the photo itself. One image per item is the simplest setup.",[50,2333,2334,2337],{},[18,2335,2336],{},"Title field",": used for alt text and captions.",[50,2339,2340,2343],{},[18,2341,2342],{},"Category field"," (optional): if you'll filter or group the gallery.",[50,2345,2346,2349],{},[18,2347,2348],{},"Order or date field",": to control the display sequence.",[14,2351,2352],{},"If each item needs several images, such as a project with ten photos, use a gallery-style field that holds multiple images per item. The slider and popup components below read that kind of field directly.",[14,2354,2355],{},"Keeping images in the CMS means adding a photo later is filling in a form, not rebuilding a layout.",[34,2357,2359],{"id":2358},"step-2-build-a-native-collection-list-grid","Step 2: Build a native Collection List grid",[14,2361,2362],{},"Drag a Collection List onto the canvas and connect it to the collection. Design the card: usually the image, cropped to a consistent aspect ratio, with the title as alt text. Set the list to a grid with fixed columns and adjust the columns per breakpoint.",[14,2364,2365],{},"For a small, uniform gallery (team photos, a short list of past projects, logo walls) this native grid may be all you need.",[34,2367,2369],{"id":2368},"step-3-where-the-native-grid-stops","Step 3: Where the native grid stops",[14,2371,2372],{},"Four gaps show up once the gallery is the point of the page.",[77,2374,2376],{"id":2375},"no-lightbox","No lightbox",[14,2378,2379],{},"Clicking an image in a native Collection List does nothing. Visitors expect a thumbnail to open a full-screen view with next/previous navigation and keyboard support. Building that by hand means wiring overlay states, click handlers and key events yourself.",[77,2381,2383],{"id":2382},"no-masonry-layout","No masonry layout",[14,2385,2386],{},"Native stacks and grids use fixed rows, so images either get cropped to the same shape or leave uneven gaps. A masonry layout, where each image keeps its natural aspect ratio and the columns flow around different heights, isn't something Framer's layout tools produce. It's the look most photography and visual portfolios want.",[77,2388,2390],{"id":2389},"simple-sliders-only","Simple sliders only",[14,2392,2393],{},"Framer's built-in Slideshow and Carousel components work for a basic swipe-through. They don't read a multi-image CMS field per item or give you a thumbnail strip, which product pages and project galleries usually need.",[77,2395,2397],{"id":2396},"basic-category-filtering","Basic category filtering",[14,2399,2400,2401,2403],{},"For a gallery split into categories (\"Weddings\", \"Portraits\", \"Events\"), Framer's native Dynamic Filters on the Collection List handle simple single-category filtering. Our ",[361,2402,1408],{"href":1407}," covers the setup and where native filtering runs out.",[1416,2405],{"button-link":1402,"button-text":1418,"description":2406,"title":2407,"variant":1421},"CMS Filter adds multi-field search, AND/OR logic, facets with counts and sorting to any Framer CMS collection, galleries included.","Gallery needs search or multi-filters?",[34,2409,2411],{"id":2410},"step-4-add-the-layout-you-need-with-a-cms-gallery-component","Step 4: Add the layout you need with a CMS gallery component",[14,2413,2414],{},"Each of these connects to the CMS collection you built in Step 1, so content stays editable in the CMS:",[106,2416,2417,2432],{},[109,2418,2419],{},[112,2420,2421,2424,2427,2430],{},[115,2422,2423],{},"Component",[115,2425,2426],{},"Layout",[115,2428,2429],{},"What it adds",[115,2431,1568],{},[125,2433,2434,2451,2468,2485],{},[112,2435,2436,2442,2445,2448],{},[130,2437,2438],{},[361,2439,2441],{"href":2440},"/components/cms-masonry-lightbox","CMS Masonry Lightbox",[130,2443,2444],{},"Masonry, 1–12 columns",[130,2446,2447],{},"Lightbox for images and video, category filter pills (single or multi-select), 4 hover effects",[130,2449,2450],{},"$29",[112,2452,2453,2459,2462,2465],{},[130,2454,2455],{},[361,2456,2458],{"href":2457},"/components/cms-gallery-lightbox","CMS Gallery Lightbox",[130,2460,2461],{},"Masonry or fixed-height grid",[130,2463,2464],{},"GLightbox viewer with CMS-driven captions; can extract images from a custom component slot",[130,2466,2467],{},"$18",[112,2469,2470,2476,2479,2482],{},[130,2471,2472],{},[361,2473,2475],{"href":2474},"/components/cms-gallery-slider","CMS Gallery Slider",[130,2477,2478],{},"Slider with thumbnails",[130,2480,2481],{},"CMS gallery-field or manual mode, thumbnails on any side, 5 transitions",[130,2483,2484],{},"$14",[112,2486,2487,2493,2496,2499],{},[130,2488,2489],{},[361,2490,2492],{"href":2491},"/components/cms-gallery-popup","CMS Gallery Popup",[130,2494,2495],{},"Lightbox popup with thumbnails",[130,2497,2498],{},"Thumbnail strip on any side, keyboard and swipe navigation",[130,2500,2467],{},[14,2502,2503],{},"All of them are also included in the Components plugin, which has 90+ components for $99 one-time.",[77,2505,2507],{"id":2506},"setting-one-up","Setting one up",[211,2509,2510,2513,2516,2519,2522],{},[50,2511,2512],{},"Add the component to the page (from its component page, or from the Components plugin inside Framer).",[50,2514,2515],{},"Connect it to your gallery collection and map the image field, plus the title for alt text and captions.",[50,2517,2518],{},"Set columns, gaps and breakpoints in the properties panel.",[50,2520,2521],{},"Turn on the extras you need: lightbox, category pills, thumbnails or hover effects.",[50,2523,2524],{},"Preview on a phone and test the swipe and close gestures before publishing.",[1416,2526],{"button-link":661,"button-text":2527,"description":2528,"title":2529,"variant":1421},"See Gallery Components","Masonry, lightbox, sliders and popups that connect to your CMS collection. Edit photos in the CMS, not the canvas.","Add a finished gallery to your Framer CMS",[34,2531,2533],{"id":2532},"which-gallery-layout-fits-your-project","Which gallery layout fits your project?",[106,2535,2536,2548],{},[109,2537,2538],{},[112,2539,2540,2543,2545],{},[115,2541,2542],{},"Project",[115,2544,2426],{},[115,2546,2547],{},"Why",[125,2549,2550,2563,2575,2588,2601],{},[112,2551,2552,2557,2560],{},[130,2553,2554],{},[18,2555,2556],{},"Photography portfolio",[130,2558,2559],{},"Masonry + lightbox",[130,2561,2562],{},"Photos have different aspect ratios, and visitors want full-screen viewing",[112,2564,2565,2570,2572],{},[130,2566,2567],{},[18,2568,2569],{},"Product gallery",[130,2571,2478],{},[130,2573,2574],{},"Several images per product, browsed one at a time",[112,2576,2577,2582,2585],{},[130,2578,2579],{},[18,2580,2581],{},"Before/after or process work",[130,2583,2584],{},"Slider",[130,2586,2587],{},"The sequence matters more than an overview",[112,2589,2590,2595,2598],{},[130,2591,2592],{},[18,2593,2594],{},"Agency case studies",[130,2596,2597],{},"Grid + popup lightbox",[130,2599,2600],{},"A tidy overview, with detail on click",[112,2602,2603,2608,2611],{},[130,2604,2605],{},[18,2606,2607],{},"Team photos or logos",[130,2609,2610],{},"Native grid",[130,2612,2613],{},"Small, uniform sets don't need more",[14,2615,2616],{},"Add a component when the project needs lightbox, masonry or thumbnail behaviour. A small uniform set is fine on the native grid.",[34,2618,2620],{"id":2619},"optimising-gallery-performance","Optimising gallery performance",[14,2622,2623],{},"Galleries are among the easiest pages to make slow.",[47,2625,2626,2632,2638,2644],{},[50,2627,2628,2631],{},[18,2629,2630],{},"Compress before upload."," Uploading a 12 MB photo and letting the layout shrink it still sends 12 MB to the visitor. Resize and compress before adding images to the CMS.",[50,2633,2634,2637],{},[18,2635,2636],{},"Serve thumbnail-sized images in the grid."," Let the lightbox load the larger version only when it opens.",[50,2639,2640,2643],{},[18,2641,2642],{},"Lazy-load below the fold."," Images far down the page shouldn't load until the visitor scrolls near them. Confirm your component does this rather than assuming.",[50,2645,2646,2649],{},[18,2647,2648],{},"Cap what renders at once."," For collections with hundreds of images, use pagination, a \"load more\" pattern or a featured subset.",[34,2651,2653],{"id":2652},"captions-alt-text-and-accessibility","Captions, alt text and accessibility",[14,2655,2656,2659],{},[18,2657,2658],{},"Alt text does two jobs."," It's an accessibility requirement and it earns image-search traffic. Map the CMS title (or a dedicated alt field) to alt text instead of leaving filenames.",[14,2661,2662,2665],{},[18,2663,2664],{},"Captions give context."," For portfolios and case studies, a short caption (project, location, one line of description) helps visitors who skim.",[14,2667,2668,2671],{},[18,2669,2670],{},"Keyboard support in the lightbox."," Arrow keys should move between images and Escape should close the viewer. Test it before launch.",[34,2673,2675],{"id":2674},"common-framer-gallery-mistakes","Common Framer gallery mistakes",[47,2677,2678,2684,2690,2696,2702],{},[50,2679,2680,2683],{},[18,2681,2682],{},"Mixed aspect ratios in a fixed grid."," Either crop consistently or switch to masonry.",[50,2685,2686,2689],{},[18,2687,2688],{},"No lightbox on a photography site."," Visitors expect to click through to the full image.",[50,2691,2692,2695],{},[18,2693,2694],{},"Full-resolution files as thumbnails."," The gallery becomes the slowest page on the site.",[50,2697,2698,2701],{},[18,2699,2700],{},"No phone testing."," Sliders and lightboxes depend on swipe feel; test on a real device.",[50,2703,2704,2707],{},[18,2705,2706],{},"No empty state for filters."," If a category has no items, say so instead of showing a blank section.",[14,2709,2710,2711,248],{},"For structuring image-heavy CMS content in general, see the ",[361,2712,2084],{"href":1412},[34,2714,1425],{"id":1424},[77,2716,2718],{"id":2717},"can-you-build-an-image-gallery-with-framers-cms","Can you build an image gallery with Framer's CMS?",[14,2720,2721],{},"Yes. Create a collection with an image field, add a Collection List, connect it and design one card. Every item becomes a gallery tile.",[77,2723,2725],{"id":2724},"does-framer-have-a-native-lightbox","Does Framer have a native lightbox?",[14,2727,2728],{},"No. A native Collection List doesn't open a full-screen viewer. Build overlay states by hand or use a gallery component with a lightbox built in.",[77,2730,2732],{"id":2731},"how-do-i-make-a-masonry-gallery-in-framer","How do I make a masonry gallery in Framer?",[14,2734,2735],{},"Native stacks and grids use fixed rows, so a true masonry layout needs a masonry gallery component connected to your CMS collection.",[77,2737,2739],{"id":2738},"does-framer-have-a-carousel-or-slideshow","Does Framer have a carousel or slideshow?",[14,2741,2742],{},"Yes. The built-in Slideshow and Carousel components handle simple sliders. For CMS-driven sliders with thumbnails, use a dedicated slider component.",[77,2744,2746],{"id":2745},"how-do-i-filter-a-framer-gallery-by-category","How do I filter a Framer gallery by category?",[14,2748,2749],{},"Use Framer's native Dynamic Filters for simple single-category filtering. CMS Masonry Lightbox also has built-in category pills with single or multi-select.",[77,2751,2753],{"id":2752},"whats-the-best-gallery-setup-for-a-photography-portfolio-in-framer","What's the best gallery setup for a photography portfolio in Framer?",[14,2755,2756],{},"Photos in a CMS collection, a masonry layout so aspect ratios aren't cropped, and a full-screen lightbox.",[34,2758,2760],{"id":2759},"build-order","Build order",[14,2762,2763],{},"Start native: collection, Collection List, one card. Publish it and look at it on a phone. If the content is photography or the images vary in shape, switch the grid to a masonry component with a lightbox; if each item has several images, use a slider with thumbnails. Then compress your images and check the page speed before you call it done.",{"title":202,"searchDepth":683,"depth":683,"links":2765},[2766,2767,2768,2774,2777,2778,2779,2780,2781,2789],{"id":2319,"depth":683,"text":2320},{"id":2358,"depth":683,"text":2359},{"id":2368,"depth":683,"text":2369,"children":2769},[2770,2771,2772,2773],{"id":2375,"depth":689,"text":2376},{"id":2382,"depth":689,"text":2383},{"id":2389,"depth":689,"text":2390},{"id":2396,"depth":689,"text":2397},{"id":2410,"depth":683,"text":2411,"children":2775},[2776],{"id":2506,"depth":689,"text":2507},{"id":2532,"depth":683,"text":2533},{"id":2619,"depth":683,"text":2620},{"id":2652,"depth":683,"text":2653},{"id":2674,"depth":683,"text":2675},{"id":1424,"depth":683,"text":1425,"children":2782},[2783,2784,2785,2786,2787,2788],{"id":2717,"depth":689,"text":2718},{"id":2724,"depth":689,"text":2725},{"id":2731,"depth":689,"text":2732},{"id":2738,"depth":689,"text":2739},{"id":2745,"depth":689,"text":2746},{"id":2752,"depth":689,"text":2753},{"id":2759,"depth":683,"text":2760},"How to build an image gallery in Framer: a native CMS grid step by step, where it stops, and how to add lightbox, masonry, sliders and category filters from your CMS.","/framerhub/img/blog/framer-cms-gallery-guide.webp",{"metaTitle":2793,"metaDescription":2794,"primaryKeyword":2795,"secondaryKeywords":2796,"heroImage":2791,"ogImage":2791,"schema":2802,"createdAt":735},"Framer Gallery: Build a CMS Image Gallery (2026) | FramerHub","Build a Framer gallery from your CMS: native Collection List grid first, then add lightbox, masonry, thumbnail sliders and category filters when you need them.","framer gallery",[2797,2798,2799,2800,2801],"framer cms gallery","framer image gallery","framer gallery component","framer lightbox","framer masonry gallery",[2803,2805],{"type":733,"headline":2282,"datePublished":2804,"dateModified":2804},"2026-10-09",{"type":737,"questions":2806},[2807,2809,2811,2813,2815,2817],{"question":2718,"answer":2808},"Yes. Create a collection with an image field, add a Collection List to the page, connect it to the collection and design one card. Every item becomes a gallery tile, and new photos are added by filling in a CMS item.",{"question":2725,"answer":2810},"No. Clicking an image in a native Collection List doesn't open a full-screen viewer. You either build overlay states by hand or use a gallery component with a lightbox built in, such as CMS Masonry Lightbox or CMS Gallery Lightbox.",{"question":2732,"answer":2812},"Framer's native stacks and grids use fixed rows, so they can't produce a true masonry layout where each image keeps its own height. Use a masonry gallery component connected to your CMS collection instead.",{"question":2739,"answer":2814},"Yes. Framer's built-in Slideshow and Carousel components handle simple swipeable galleries. For CMS-driven sliders with thumbnail navigation, or effects like coverflow, use a dedicated slider component.",{"question":2746,"answer":2816},"For simple single-category filtering, use Framer's native Dynamic Filters on the Collection List. CMS Masonry Lightbox also has built-in category filter pills with single or multi-select modes.",{"question":2753,"answer":2818},"Store photos in a CMS collection, show them in a masonry layout so different aspect ratios aren't cropped, and add a full-screen lightbox, since that's how visitors view photography.","/blog/framer-cms-gallery-guide","2026-10-09T00:00:00.000Z",{"title":2282,"description":2790},"framer-cms-gallery-guide","blog/framer-cms-gallery-guide",[762,1058,811,763],"vbCX3fFEboMUlFaIP9XWRoHsBK99V7PF4FlDYhd1OiI",1794241468183]