Lumifeed Docs
Widget

HTML / Vanilla JS

Add the Lumifeed widget to any HTML page with one line of code.

HTML / Vanilla JS

The simplest integration. Add this before your closing </body> tag:

<script
  src="https://cdn.lumifeed.app/widget.js"
  data-key="YOUR_API_KEY"
  defer
></script>

Configuration attributes

AttributeTypeDefaultDescription
data-keystringRequired. Your project API key
data-positionstringbottom-rightButton position: bottom-right, bottom-left, top-right, top-left
data-themestringautolight, dark, or auto
data-labelstringFeedbackButton label text
data-primary-colorstring#7c6af4Brand accent color (hex)

Example with options

<script
  src="https://cdn.lumifeed.app/widget.js"
  data-key="pk_live_abc123"
  data-position="bottom-left"
  data-theme="dark"
  data-label="Give feedback"
  data-primary-color="#0ea5e9"
  defer
></script>

JavaScript API

Once the script is loaded, use window.Lumifeed to control the widget:

// Open the widget programmatically
window.Lumifeed.open()

// Close the widget
window.Lumifeed.close()

// Identify the current user
window.Lumifeed.identify({
  userId: "user_123",
  name: "Ada Lovelace",
  email: "ada@example.com",
})

// Listen for submission events
window.Lumifeed.on("submit", (feedback) => {
  console.log("Feedback submitted:", feedback.id)
})

On this page