How to Integrate Duda into a SaaS platform (1/3)

August 21, 2024
0 minute read

Offering websites can be a big win for SaaS companies in terms of reducing churn, increasing revenue and raising customer satisfaction. Imagine the benefits of providing your users with a zero-friction, instant website solution, pre-populated with their personalized content all from within your platform’s UI. 


How much time would your customers save if their website content always stayed up-to-date with the changes they made during their day-to-day usage of your product? The benefits to you and your users would be immense. You’d be happy because you can charge for managing a larger portion of your customer’s business, and your customers would be grateful for the additional time savings and convenience your platform now provides.


Let’s assume you’ve done your research and decided partnering with a website builder is the right move for your business. Naturally, you’ve chosen Duda, as it’s the only editor you can truly make your own. With features like a white-labeled UI, API for programmatic site generation, and the ability to push data directly from your platform to your users’ websites, Duda is the most malleable website builder on the market. 


No more dealing with the maintenance nightmare of one-off WordPress sites, and no need to divert your valuable development resources to create an in-house website editor. Duda will provide you with everything you need to augment your core feature set with website building capabilities that will delight your customers.


All of this sounds great, but if you are like most SaaS companies, you want to know exactly what integration entails. This post is one part of a series that will walk you through the steps needed to enable your customers to create truly beautiful sites with the click of a button. The first step of that process is creating the templates your users will choose from when they build a new site.


Connected templates


With Duda templates, you have the ability to separate content from design. If you previously used WordPress, this is probably a familiar concept. You create a theme (design), and then later you publish a page or post (content). When a user visits the website, WordPress inserts the content into the design and displays the webpage. 


Duda works along similar lines — the templates not only store the design, but also the data connections that allow content to be injected into the template’s layout. You can think of these connected templates as a promise. You’re telling the template, “I’m going to send you some data at some point in the future. When you receive it, you need to display it here.”



The actual content of the site is stored in the template’s Content Library. The Content Library is a series of label/value pairs that hold content. Some labels we provide by default, but additional labels can be added to suit your needs. You can add the values for these labels manually within the editor, or programmatically via our API.


When you connect a widget in your template to data in the library, you’re able to pick from a list of available labels. That’s the promise I mentioned above. This action tells the template that the value in the Content Library identified by this label is what should display in this spot.



Your users are probably uploading a treasure trove of content simply through their day-to-day usage of your SaaS platform. Your product might also be computing additional data using that content. When thinking through your template creation, take note of all these inputs and outputs within your product, and decide which values would be pertinent to display on a website. For each piece of data you pick, add a corresponding label in the Content Library. Some examples of useful data might include:


  • Business Name
  • Business Logo
  • Physical Addresses
  • Email Addresses
  • Telephone Numbers
  • Business Overview/About Us
  • Business Hours
  • Social Media Accounts
  • Etc


You might not end up using all the values you identified immediately, but having the values in the Content Library will give you flexibility in the future to update a user’s site with more functionality and information. 


After populating the Content Library with all of your labels, you can add placeholder values to aid you while designing the template. When you create an actual site, you will overwrite the placeholder values with real data. The final step is to connect the elements on your template to labels in the Content Library once you’re satisfied with the design and layout.


Instant sites


With your template connections complete, it’s time to implement the API calls necessary to allow your users to instantly create their websites. 


Ideally, your customers should be able to click a “Create Website” button within your SaaS product. Doing so would provision a site based on one of your templates, then push the stored data in your platform to the site’s Content Library. Those promises you made at the template level are now fulfilled, as the new content is deposited into their proper places within the template. At its simplest, this instant website flow only requires two calls to the Duda API.



“Create Site” API call 


The create site API call only requires a template_id value to succeed. The template ID identifies which template you want to be the basis for the site. All you need to do is provide the ID of a template with a completed design and configured data connections. You can manually retrieve the template ID via API during development and store the value within your code or database.


You can retrieve template IDs from the list templates API endpoint. Template IDs do not change, so you can safely cache these IDs in your own code or database.

API call

 

curl --request POST \ 

--url https://api.duda.co/api/sites/multiscreen/create \ 

--header 'authorization: Basic123abc=' \ 

--header 'content-type: application/json' \ 

--data '{"template_id":"1111111"}'


Note: API calls require an API username and password to authenticate.


If your call is successful you will receive a site_name back in the response. You should save this value and associate it with an account or entity within your platform as you’ll need it later for some other API calls.


API response

 

{ "site_name":"28e1182c" }


“Update Content Library” API call


Creating a website from a template, whether by API or from within the editor, copies over the design and data connections of that template. It also copies over the values within the Content Library, which if you were following along above, are currently placeholder values at this point in the process. Now it’s time to update those values with real data from this customer. 


The API call to update the Content Library requires a specific content object schema. However, you only need to include the properties you are updating. Pay particular attention to the site_texts property and how to format values belonging to custom labels.


API call

 

curl --request POST \ 

    --url https://api.duda.co/api/accounts/create \ 

    --header 'authorization: Basic Basic123abc' \ 

    --header 'content-type: application/json' \ 

    --data 'VALID CONTENT OBJECT'


Your new values will populate in the Content Library, and the data connections you set up previously will make sure the new content is sorted into the correct spots of the design. 


If you’ve followed all of these steps then congratulations, you’ve just created an instant site!



Summing up


Hopefully, this post has sparked some conversation about what types of content you could sync to a Duda website and has, overall, been a useful tool for planning your own integration strategy.


The next post in this series will dive a little deeper by first exploring how to programmatically manage user permissions, allowing them to edit their new site through a single sign-on workflow. We’ll also discuss the many ways you can customize your users’ experience using permissions, then we’ll finish up by discussing advanced features like complex data structures and automatic page generation triggered by data changes within your platform.


Until then, take the opportunity to explore our API documentation and developer guides. These can further your understanding of what’s possible with Duda’s powerful platform.


Jason

Jason Hummel

Director of Solution Engineering, Duda

With over 25 years of web development experience, Jason is focused on providing elegant, usable solutions that follow current industry standards.


Did you find this article interesting?


Thanks for the feedback!
By Shawn Davis April 1, 2026
Core Web Vitals aren't new, Google introduced them in 2020 and made them a ranking factor in 2021. But the questions keep coming, because the metrics keep changing and the stakes keep rising. Reddit's SEO communities were still debating their impact as recently as January 2026, and for good reason: most agencies still don't have a clear, repeatable way to measure, diagnose, and fix them for clients. This guide cuts through the noise. Here's what Core Web Vitals actually measure, what good scores look like today, and how to improve them—without needing a dedicated performance engineer on every project. What Core Web Vitals measure Google evaluates three user experience signals to determine whether a page feels fast, stable, and responsive: Largest Contentful Paint (LCP) measures how long it takes for the biggest visible element on a page — usually a hero image or headline — to load. Google considers anything under 2.5 seconds good. Above 4 seconds is poor. Interaction to Next Paint (INP) replaced First Input Delay (FID) in March 2024. Where FID measures the delay before a user's first click is registered, INP tracks the full responsiveness of every interaction across the page session. A good INP score is under 200 milliseconds. Cumulative Layout Shift (CLS) measures visual stability — how much page elements unexpectedly move while content loads. A score below 0.1 is good. Higher scores signal that images, ads, or embeds are pushing content around after load, which frustrates users and tanks conversions. These three metrics are a subset of Google's broader Page Experience signals, which also include HTTPS, safe browsing, and mobile usability. Core Web Vitals are the ones you can most directly control and improve. Why your clients' scores may still be poor Core Web Vitals scores vary dramatically by platform, hosting, and how a site was built. Some of the most common culprits agencies encounter: Heavy above-the-fold content . A homepage with an autoplay video, a full-width image slider, and a chat widget loading simultaneously will fail LCP every time. The browser has to resolve all of those resources before it can paint the largest element. Unstable image dimensions . When an image loads without defined width and height attributes, the browser doesn't reserve space for it. It renders the surrounding text, then jumps it down when the image appears. That jump is CLS. Third-party scripts blocking the main thread . Analytics pixels, ad tags, and live chat tools run on the browser's main thread. When they stack up, every click and tap has to wait in line — driving INP scores up. A single slow third-party script can push an otherwise clean site into "needs improvement" territory. Too many web fonts . Each font family and weight is a separate network request. A page loading four font files before rendering any text will fail LCP, especially on mobile connections. Unoptimized images . JPEGs and PNGs served at full resolution, without compression or modern formats like WebP or AVIF, add unnecessary weight to every page load. How to measure them accurately There are two types of Core Web Vitals data you should be looking at for every client: Lab data comes from tools like Google PageSpeed Insights, Lighthouse, and WebPageTest. It simulates page loads in controlled conditions. Lab data is useful for diagnosing specific issues and testing fixes before you deploy them. Field data (also called Real User Monitoring, or RUM) comes from actual users visiting the site. Google collects this through the Chrome User Experience Report (CrUX) and surfaces it in Search Console and PageSpeed Insights. Field data is what Google actually uses as a ranking signal — and it often looks worse than lab data because it reflects real-world device and connection variability. If your client's site has enough traffic, you'll see field data in Search Console under Core Web Vitals. This is your baseline. Lab data helps you understand why the scores are what they are. For clients with low traffic who don't have enough field data to appear in CrUX, you'll be working primarily with lab scores. Set that expectation early so clients understand that improvements may not immediately show up in Search Console. Practical fixes that move the needle Fix LCP: get the hero image loading first The single most effective LCP improvement is adding fetchpriority="high" to the hero image tag. This tells the browser to prioritize that resource over everything else. If you're using a background CSS image for the hero, switch it to anelement — background images aren't discoverable by the browser's preload scanner. Also check whether your hosting serves images through a CDN with caching. Edge delivery dramatically reduces the time-to-first-byte, which feeds directly into LCP. Fix CLS: define dimensions for every media element Every image, video, and ad slot on the page needs explicit width and height attributes in the HTML. If you're using responsive CSS, you can still define the aspect ratio with aspect-ratio in CSS while leaving the actual size fluid. The key is giving the browser enough information to reserve space before the asset loads. Avoid inserting content above existing content after page load. This is common with cookie banners, sticky headers that change height, and dynamically loaded ad units. If you need to show these, anchor them to fixed positions so they don't push content around. Fix INP: reduce what's competing for the main thread Audit third-party scripts and defer or remove anything that isn't essential. Tools like WebPageTest's waterfall view or Chrome DevTools Performance panel show you exactly which scripts are blocking the main thread and for how long. Load chat widgets, analytics, and ad tags asynchronously and after the page's critical path has resolved. For most clients, moving non-essential scripts to load after the DOMContentLoaded event is a meaningful INP improvement with no visible impact on the user experience. For websites with heavy JavaScript — particularly those built on frameworks with large client-side bundles — consider breaking up long tasks into smaller chunks using the browser's Scheduler API or simply splitting components so the main thread isn't locked for more than 50 milliseconds at a stretch. What platforms handle automatically One of the practical advantages of building on a platform optimized for performance is that many of these fixes are applied by default. Duda, for example, automatically serves WebP images, lazy loads below-the-fold content, minifies CSS, and uses efficient cache policies for static assets. As of May 2025, 82% of sites built on Duda pass all three Core Web Vitals metrics — the highest recorded pass rate among major website platforms. That baseline matters when you're managing dozens or hundreds of client sites. It means you're starting each project close to or at a passing score, rather than diagnosing and patching a broken foundation. How much do Core Web Vitals actually affect rankings? Honestly, they're a tiebreaker — not a primary signal. Google has been clear that content quality and relevance still dominate ranking decisions. A well-optimized site with thin, irrelevant content won't outrank a content-rich competitor just because its CLS is 0.05. What Core Web Vitals do affect is the user experience that supports those rankings. Pages with poor LCP scores have measurably higher bounce rates. Sites with high CLS lose users mid-session. Those behavioral signals — time on page, return visits, conversions — are things search engines can observe and incorporate. The practical argument for fixing Core Web Vitals isn't just "because Google said so." It's that faster, more stable pages convert better. Every second of LCP improvement can reduce bounce rates by 15–20% depending on the industry and device mix. For client sites that monetize through leads or eCommerce, that's a revenue argument, not just an SEO argument. A repeatable process for agencies Audit every new site before launch. Run PageSpeed Insights and record LCP, INP, and CLS scores for both mobile and desktop. Flag anything in the "needs improvement" or "poor" range before the client sees the live site. Check Search Console monthly for existing clients. The Core Web Vitals report surfaces issues as they appear in field data. Catching a regression early — before it compounds — is significantly easier than explaining a traffic drop after the fact. Document what you've improved. Clients rarely see Core Web Vitals scores on their own. A monthly one-page performance summary showing before/after scores builds credibility and makes your technical work visible. Prioritize mobile. Google uses mobile-first indexing, and field data shows that mobile CWV scores are almost always worse than desktop. If you only have time to optimize one version, do mobile first. Core Web Vitals aren't a one-time fix. Platforms change, new scripts get added, campaigns bring in new widgets. Build the audit into your workflow and treat it like any other ongoing deliverable, and you'll stay ahead of the issues before they affect your clients' rankings. Duda's platform is built with Core Web Vitals performance in mind. Explore how it handles image optimization, script management, and site speed automatically — so your team spends less time debugging and more time building.
By Ilana Brudo March 31, 2026
Vertical SaaS must transition from tools to an AI-powered Vertical Operating System (vOS). Learn to leverage context, end tech sprawl, and maximize retention.
By Shawn Davis March 27, 2026
Automate client management, instant site generation, and data synchronization with an API-driven website builder to create a scalable growth engine for your SaaS platform.
Show More

Latest posts