# qualtive-web

> Client library for Qualtive.

Latest version **1.27.1** (published 2026-04-10) · ISC license · 0 weekly downloads

## Install

```sh
npm install qualtive-web
pnpm add qualtive-web
yarn add qualtive-web
bun add qualtive-web
```

## Health

**Score 55/100 (C)** — status: active.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.27.1 |
| Published | 2026-04-10 |
| First published | 2020-08-16 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 172.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Qualtive |
| Maintainers | qualtive-account, rosecoder |

## Links

- npm: https://www.npmjs.com/package/qualtive-web
- Repository: https://github.com/nightshift-habits/qualtive-client-web
- Homepage: https://github.com/nightshift-habits/qualtive-client-web#readme
- Issues: https://github.com/nightshift-habits/qualtive-client-web/issues
- npm.io page: https://npm.io/package/qualtive-web

## Recent versions

- 1.27.1 (latest) — 2026-04-10
- 1.27.0 — 2026-03-27
- 1.26.0 — 2025-11-10
- 1.25.1 — 2025-10-07
- 1.25.0 — 2025-10-04
- 1.24.2 — 2025-08-28
- 1.24.1 — 2025-08-08
- 1.24.0 — 2025-08-08
- 1.23.0 — 2025-07-26
- 1.22.0 — 2025-05-18
- 1.21.0 — 2025-04-18
- 1.20.1 — 2025-04-03
- 1.20.0 — 2025-03-25
- 1.19.0 — 2025-03-22
- 1.18.0 — 2024-12-10
- … 37 more at https://npm.io/package/qualtive-web/versions

## README

# Qualtive Client Library for Web

## Installation

```
npm install qualtive-web
```

TypeScript types are included in this package.

## Usage

First of all, make sure you have created a question on [qualtive.io](https://qualtive.io). Each feedback entry is posted to a so called collection (ID) which can be found in the question page.

### Using Built-in UI

To present a feedback form, use the `presentEnquiry`-function. For example:

```typescript
import * as qualtive from "qualtive-web"

qualtive.presentEnquiry("my-company/my-question")
```

There is a few options to customize the UI. For example:

```typescript
import * as qualtive from "qualtive-web"

qualtive.presentEnquiry("my-company/my-question", {
  supportURL: "https://link-to-your-customer-service/", // If present, this will show a link to your customer support.
  locale: "en-US", // Optional. The language and formatting to use. Defaults to the device default.
})
```

If users can login on your site, you can include a user property describing the user. For example:

```typescript
import * as qualtive from "qualtive-web"

qualtive.presentEnquiry("my-company/my-question", {
  user: {
    id: "user-123", // Authorized user id. Used to list feedback from the same user. Optional.
    name: "Steve", // User friendly name. Can be the users full name or alias. Optional.
    email: "steve@gmail.com", // Reachable email adress. Optional.
  },
})
```

You can even include custom attributes that will be shown on [qualtive.io](https://qualtive.io). For example:

```typescript
import * as qualtive from "qualtive-web"

qualtive.presentEnquiry("my-company/my-question", {
  customAttributes: {
    age: 22,
  },
})
```

### Using Custom UI

To post a feedback entry, use the `post`-function. For example:

```typescript
import * as qualtive from "qualtive-web"

qualtive.post("my-company/my-question", {
  score: 75, // Score between 0 and 100 where 0 is saddest and 100 is happiest.
  text: "Hello world!", // Optional user typed text.
})
```

If users can login on your site, you can include a user property describing the user. For example:

```typescript
import * as qualtive from "qualtive-web"

qualtive.post("my-company/my-question", {
  score: 75,
  user: {
    id: "user-123", // Authorized user id. Used to list feedback from the same user. Optional.
    name: "Steve", // User friendly name. Can be the users full name or alias. Optional.
    email: "steve@gmail.com", // Reachable email adress. Optional.
  },
})
```

You can even include custom attributes that will be shown on [qualtive.io](https://qualtive.io). For example:

```typescript
import * as qualtive from "qualtive-web"

qualtive.post("my-company/my-question", {
  score: 75,
  customAttributes: {
    age: 22,
  },
})
```

## Supported languages

The built-in UI supports the following languages:

- English
- Swedish

---
_Source: https://npm.io/package/qualtive-web · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._