Web apps

How to turn a website into a web app

How to turn a website into a web app

In TeleportHQ, a website becomes a web app the first time you add something that needs a server, such as user sign-in, a store, a blog, bookings, a newsletter, an AI chatbot or a workflow step that runs on the server. TeleportHQ opens the Enable Web App features? window, and you confirm with Enable Web App features. Afterwards you can still publish from TeleportHQ, but you can no longer download the project's code. The change isn't permanent: click Undo in the message that follows, or later use Switch to Presentation Website in Project settings → General. Showing and hiding elements, pop-ups, tabs and browser widgets such as calendars never need a web app.

Before you start

  • Check that you need a web app. Elements that show or hide on a click, pop-ups (modals), tabs, collapsible text, calendars, countdowns, a kanban board, drag and drop, a cookie banner and a language switcher all work in a website. So do workflows whose steps all run in the visitor's browser, and content from a data source. See What is a web app in TeleportHQ?
  • Decide if you need code download. A web app can't be downloaded as HTML, React or Next.js code. If you plan to host the code yourself, keep the project as a presentation website. See Can I download my site's code?
  • Check your Web App slots. A web app that isn't covered by a Web App slot gets 7 days of full access, then goes offline. Trial and Premium workspaces include 1 slot; Pro includes none. When the window knows what the switch costs your workspace, it says so in a first line, It takes a web app slot. See Why does my web app need a slot, and what is the 7-day window?
  • You need permission to edit the project.

Steps

This example starts the switch by turning on the Blog.

  1. Open your website project in the TeleportHQ editor.
  2. In the left sidebar, click Plugins.
  3. In the Plugins list, click Blog. Its drawer opens beside the list.
  4. At the top of the drawer, turn on Blog enabled. The Enable Web App features? window opens.
  5. Read the box Before you continue, please read carefully:
    • Code download will no longer be available.
    • You can still deploy this project directly from TeleportHQ.
    • You can switch back to a presentation website from Project settings, as long as nothing in the web application needs web app features any more.
  6. Click Enable Web App features. TeleportHQ saves a backup named Before Web App features Enabled, makes the project a web app and continues with the feature you started adding. A project that is still blank (an empty home page and no components) gets no backup, because there is nothing in it to restore.

A message then reads "This project is now a web application." with an Undo button. It stays for about 15 seconds. Click Undo to take back what you added and make the project a presentation website again.

To cancel instead, click Keep as a Presentation Website. Nothing changes, and the feature isn't added.

The TeleportHQ Enable Web App features? window with its warnings and the Keep as a Presentation Website and Enable Web App features buttons

Other things that open the same window

In a TeleportHQ website, each of these opens the Enable Web App features? window first:

  • Adding a step that runs on the server to a workflow, for example sending an email or saving a record. Creating a workflow, and adding steps that only run in the visitor's browser (showing, hiding, navigating, changing a state), keep the project a website. The window comes with the first step that needs the server.
  • Turning on Authentication, E-commerce, Blog, Help Center, Bookings, AI assistant chat, Newsletter or Item comparison in Plugins (above Growth in the left sidebar). The Admin panel can be turned on only after Authentication, so by then the project is already a web app. Instant search and Age gate & geo block never need a web app.
  • Ticking plugins in the Choose your plugins window and clicking its button, for example Enable 2 plugins. The window opens from Project Menu → Edit → Enable Plugins…, and on its own the first time you open a new Blank project. See How to turn features on or off (Plugins).
  • Adding Site Search, Newsletter Signup (or a Footer that includes one), Autocomplete or Upload Asset from Elements → Primitives.
  • Clicking Enable Web App features in Project settings → Data & code → Global state.
  • Ticking Cache results on a list that shows data from a data source.
  • Sending your first message to the Marketing Assistant in the Marketing Studio.
  • Finishing an AI generation whose pages include workflows or live data. The window then says "The generated pages include web app features (workflows or live data). Enable them to keep the pages working."
  • Using Undo or Redo in the editor in a way that brings back something that needs a server. If you click Keep as a Presentation Website, that step is taken back again.
The TeleportHQ Plugins panel of a website, with the Authentication, E-commerce, Blog, Help Center, Bookings and AI assistant chat rows highlighted

When you ask the AI Assistant for a server feature by name (for example, "add a login page" or "add a blog"), TeleportHQ treats your request as confirmation and doesn't show the window.

Check that it worked

  • The feature you were adding is now in your project.
  • On the dashboard, the project card shows a Web App chip.
  • In Project settings → General, the project type reads Web App.
  • If the project isn't covered by a Web App slot, a banner appears at the bottom of the editor: "This web app has full access — including publishing with a TeleportHQ watermark — but needs its own subscription to keep it." with a Subscribe project button.

Switch a web app back to a presentation website

A TeleportHQ web app can become a presentation website again from Project settings. Switching back removes everything in the project that needs a server, so check the list before you confirm.

  1. At the bottom of the left sidebar, click the Project settings cog.
  2. In the Site group, click General.
  3. Find the project type, which reads Web App. Below it, "Switching to a presentation website removes:" lists each thing that needs a server: plugins that are on, workflows that run on the server, global states and the project's own database. Click a row to open it and look at it first.
  4. Click Switch to Presentation Website. The Switch back to a Presentation Website? window opens. It lists what is Turned off (plugins) and what is Deleted (workflows, global states, the database).
  5. If the project has its own TeleportHQ database, tick Delete the project database and every record in it. Records cannot be restored, not even from a backup. The button stays greyed out until you do.
  6. Click Switch back, or Switch back and republish when your site is live on TeleportHQ. A message reads "This project is a presentation website again."

What happens when you switch back:

  • A backup comes first. When your plan includes backups, TeleportHQ saves one named Before switching back to a Presentation Website before it removes anything, and the window says "A backup is saved first, so you can restore the rest from Backups." Without backups (on the trial), the window says "Your plan has no backups, so this cannot be restored afterwards."
  • Records in the project database are gone for good, even if you restore the backup.
  • Newsletter issues scheduled to go out are canceled, and a backup doesn't bring them back.
  • Elements linked to a global state lose that link. The window says how many.
  • Code download comes back, and the project's Web App slot is freed for another project.
  • Your live site is republished as a website, with your latest changes, when it's published on TeleportHQ. If the republish fails, publish again from the Publish window.

When nothing in the project needs a server any more, the section reads "Nothing in it needs a server any more, so it can go back to being a presentation website." and switching back removes nothing. A store created with AI can't switch back: the section reads "An AI store is always a web application."

Troubleshooting

I only wanted a pop-up, tabs or a show/hide effect You don't need a web app for those. Click Keep as a Presentation Website if the window opens, then add the pop-up or the condition directly. See How to add a pop-up (modal) and How to show or hide elements based on a condition.

AI-generated pages don't work until I enable web app features When an AI generation adds workflows or live data to a website, TeleportHQ asks with the Enable Web App features? window. If you click Keep as a Presentation Website, those parts stay on the pages but don't run. Add the feature again to see the window again.

I switched by mistake Right after the switch, click Undo in the "This project is now a web application." message. Later, switch back from Project settings → General (see above). You can also restore the backup named Before Web App features Enabled, which TeleportHQ saved right before the switch: it brings the whole project back to how it was at that moment, so everything you changed since is lost too. In the editor, click Backups in the bottom toolbar, then Restore next to that backup. Backups aren't included in the trial. See How to back up and restore your project.

"It is still a web application: … could not be removed." Switching back stopped because something couldn't be turned off or deleted. Open it from where it lives (its plugin, the Workflows panel or the Data panel), remove it, then switch back again.

"Could not save a backup first, so nothing was changed." TeleportHQ didn't remove anything, because the backup it promised couldn't be saved. Try again in a moment.

Good to know

  • Projects created with the Presentation Website or Blank project card start as websites. Projects created with the E-commerce, Web App or Bookings card are web apps from the start. They can switch back the same way, except a store that TeleportHQ's AI generated.
  • The data behind a plugin you turn off, such as products, posts or bookings, stays in your data source. Only the project's own TeleportHQ database is deleted when you switch back.
  • A web app's download window says it can only be exported in TeleportHQ's own format, with a Switch back to a presentation website link that opens Project settings → General.
Share

Related Articles

What is a web app in TeleportHQ?

In TeleportHQ, a web app is a project that uses server features (workflows, user sign-in, a store, bookings, a blog or help center, an admin panel, an AI chatbot); it publishes from TeleportHQ, can't be downloaded as code, and needs a Web App slot to keep running after 7 days, while show/hide, pop-ups and browser widgets work in websites too.

What's the difference between a website and a web app?

In TeleportHQ, a website (a presentation website) presents information and its code can be downloaded, while a web app adds workflows, user accounts, a store, a blog, a newsletter or online bookings, can't have its code downloaded while those features are on, can be switched back to a website from Project settings → General, and needs a Web App slot to stay online after 7 days.

Why does my web app need a slot, and what is the 7-day window?

In TeleportHQ, each web app needs its own Web App slot to keep publishing and running; a web app without one gets 7 days of full access with a watermark, then its site goes offline and it is archived until you add a slot, and it is never deleted.

How to turn features on or off (Plugins)

In the TeleportHQ editor, click Plugins in the left sidebar, click a plugin such as Blog, Bookings or Authentication, and flip its "enabled" switch in the drawer that opens; the same drawer starts its tutorial, opens its panel, shows or hides its left-sidebar button and lists what needs attention, and flipping the switch again and confirming turns it off.

How to back up and restore your project

In the TeleportHQ editor, click Backups in the bottom toolbar, then Backup current project state to save a snapshot, or Restore next to a backup (such as Before Web App features Enabled) to bring the project back to that point; backups need a Pro or Premium plan, trial users ask support to restore, and you must republish afterwards.

Can I download my site's code?

Yes, on a paid TeleportHQ plan (Pro or Premium) you can download a website's code as HTML, React, Next.js, Vue, Nuxt or Angular, or export it to GitHub; a trial only lets you view the code (10 code views), and web apps can't be downloaded as code.