Getting started

Quickstart

Embed a Vlozi form on your website in under two minutes.

Step 1 — Create a form

Open the Vlozi dashboard → FormsNew form. Give it a name, add your fields, and save. Copy the Form ID (looks like form_abc123…).

Step 2 — Choose your embedding method

Option A: Hosted page (zero code)

Share this URL directly — in an email, social post, or as a standalone landing page:

https://api.vlozi.app/forms/f/YOUR_FORM_ID/page

The page is automatically themed using your form's brand settings and includes spam protection.


Option B: Script embed widget

Add two lines of HTML anywhere on your page:

<div data-vlozi-form="YOUR_FORM_ID"></div>
<script src="https://api.vlozi.app/forms/f/embed.js" async></script>

The widget fetches your form schema, renders the fields, and handles submission — including file uploads and success/error messages.


Option C: @vlozi/forms SDK

Install the package:

npm install @vlozi/forms

Submit from your own UI:

import { createFormClient } from "@vlozi/forms";
 
const form = createFormClient({ formId: "YOUR_FORM_ID" });
 
const result = await form.submit({
  email: "visitor@example.com",
  message: "Hello!",
});
 
if (result.success) {
  console.log(result.message); // "Thank you! Your submission has been received."
} else {
  console.error(result.errors);
}

Option D: Plain HTML form (no JS, no SDK)

Works with any <form> tag — no JavaScript required:

<form action="https://api.vlozi.app/forms/f/YOUR_FORM_ID" method="POST">
  <input type="email" name="email" required placeholder="your@email.com" />
  <textarea name="message" required placeholder="Your message"></textarea>
 
  <!-- Spam protection: always include this hidden honeypot -->
  <input type="checkbox" name="botcheck" style="display:none" tabindex="-1" autocomplete="off" />
 
  <!-- Redirect after success -->
  <input type="hidden" name="redirect" value="https://yoursite.com/thank-you" />
 
  <button type="submit">Send</button>
</form>

TIP

Always include the redirect hidden field when using plain HTML forms. Without it, the browser displays a raw JSON response after submission.

Step 3 — View submissions

Open the Vlozi dashboard → Forms → your form → Submissions. New submissions appear here the moment they arrive. You can mark them as seen, handled, or spam, leave notes, and reply directly by email.

Forms · Getting startedEdit on GitHub