Customize your site
How Super works
Super takes your Notion pages and turns them in to a fast and performant, SEO-optimized website. And this means it works a bit differently to Notion and other website builders.
Super and Notion workflow
In a nutshell, you manage your content in Notion, and manage your site in Super.
Notion is where the content for your site lives and is the place you spend most of your time when creating your site. You use Notion to:
- Manage your content
- Update text, images and other media
- Create site pages
- Create your site layout and structure
Super works behind the scenes to turn your pages into a fast, performant site and you use it to:
- Manage your site SEO settings
- Manage your site pages
- Add a domain to your website
- Customize the appearance of your site
How Super sites update
Super sites update automatically in the background. These updates take on average 2 minutes but can at times take a little longer. Here's what's going on behind the scenes:
- When making changes in Notion there is about a 30 second caching delay between your updates and what Super gets from Notion's API.
- When visiting a page, Super always serves from CDN (Content Delivery Network) cache to keep sites fast. Page cache expires after 15 seconds.
- When the cache has expired the stale page is served to the visitor, updates are retrieved from the Notion API and cached by Super for the next visitor.
- If you've visited a page recently changes become visible after local browser cache has expired.
Updates not displaying on your site
There are only a few reasons why updates aren't showing on your site, use the sections below to understand and troubleshoot the issue.
Updating the CDN Cache
Super uses a CDN (Content Delivery Network) to optimize the delivery of content to your users so sites are scalable and fast. The CDN Cache is updated on demand when someone visits your site (this means that once your site is receiving regular traffic it will automatically stay up to date. If you have a very quiet site, you may need to trigger the CDN update manually).
You can trigger a CDN cache update by visiting a page 15 seconds after the last page visit. This visit will get the previous content from the cache and in the background the CDN cache is updated ready for the next visit.
Updates still aren't showing
In some circumstances, the automatic refreshes of these APIs and caches can mean that it seems like your site is not updating, but the cache refresh is just going through its cycle. And even though at each step the timeout is 15 to 30 seconds, sometimes these become cumulative and add up to a seemingly long time period. In this case, please allow up to 15 minutes to allow all the cache's to update and if after 12 hours your site is still not updated, reach out to our customer service for help.
Remember there are multiple levels of caching going on – Notion caches updates that get published to their API, Super caches updates to the CDN, and the CDN caches content, and finally, the browser caches the content.
Clearing the browser cache
When you are developing your site, it can be exciting to see the changes live in the browser. But sometimes when you visit your site in the browser, you might notice the page has not updated. This is because modern browsers cache your sites content (keep a copy of it) to make it load faster.
In order to clear the cache and view the latest updates directly from Super, you'll need to force refresh your browser. Please note: If you've made recent changes in Notion or Super, you'll need to force refresh the browser twice 15-30 seconds apart. Once to trigger the CDN cache refresh, and a second time to retrieve the update content.
How to hard / force refresh and clear your browser cache: In most browsers on PC and Mac, you can perform a simple action to force a hard refresh. Hold down the Shift key on your keyboard and click on the reload icon on your browser’s toolbar. For more specific instructions for your Operating system and browser, check out this page.
How to get consistent updates on your site
We use Super for all our sites too, and our staff have their own Super sites. The best way to check if updates have been made on your site is to use the site preview via the Super Dashboard. If updates are showing here, then you can be confident that the updates will show on the live site once the cache cycle has completed.
Our way of developing our sites making sure that sites display updates smoothly and frequently is as follows:
- Make a change in Notion (remember this can take 30 seconds to be published to Notion API)
- Head into your Site preview in the site editor via the Super dashboard and refresh the page (top right refresh button) (this can take 30 sec depending on Notion API Cache and how often changes are made in Notion)
- Visit your site in the browser and perform a hard/force refresh – this will usually trigger a CDN cache refresh
- Force refresh the page in the browser again – page content should now be up to date.
- If changes aren't appearing in the page after 2 hard refreshes, you can try hard refreshing a few more times
The expected total time from Notion content change to published content visible will be between 1-2 minutes. This is a by-product of the architectural decision to make Super incredibly high performant and scalable.
Even if changes are not being displayed to your website right away, you can continue to manage content in Notion confidently knowing that your site changes will be displayed eventually. In the rare occasion where your site has not updated within 12 hours, please contact our customer support team.
Troubleshooting and Tips
If updates are showing in the Super dashboard preview but not in the browser:
- the browser cache needs clearing (Try hard refreshing your site)
If updates are not showing in the Super dashboard preview:
- the Notion API has not delivered the updates to Super yet, wait a few minutes and press the refresh button at the top right of the Dashboard preview.