---
title: Rating Scale
product: Form Library
description: Learn how to configure a Rating Scale question using various representation options, including numbers, stars, smileys, or any custom labels of your choice. View a free demo for JavaScript to learn more.
framework: Vue 3
source: https://surveyjs.io/form-library/examples/rating-scale/vue3js
index: https://surveyjs.io/form-library/examples/overview.md
---

# Rating Scale (Vue 3)

A Rating Scale question asks respondents to evaluate a particular characteristic of a product or service on a predefined scale. The scale can display a range of numbers, graphic symbols (stars, emojis), or descriptive terms that represent different degrees of agreement, satisfaction, or other subjective measures. This example demonstrates how to add a Rating Scale question to your survey or form and configures the question's scale values and appearance.

## Create a Rating Scale Question

To add a Rating Scale question to your survey or form, define an object with the `type` property set to `"rating"` and add it to the [`elements`](https://surveyjs.io/form-library/documentation/pagemodel#elements) array. Within this object, specify the question's [`title`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#title) and a unique [`name`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#name) that identifies the question. Optionally, you can specify a [`description`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#description) to place under the `title`.

## Generate or Specify Scale Values

The following properties allow you to generate rate scale values:

- [`rateMin`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMin): `Number`\
The first value in the generated sequence of rate values.
- [`rateMax`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMax): `Number`\
The last value in the generated sequence of rate values.
- [`rateCount`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateCount): `Number`\
The number of rate values you want to generate.
- [`rateStep`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateStep): `Number`\
A step with which to generate rate values.

You can combine these properties as required. The following code snippets show combination examples and results they produce:

```js
{ "rateMin": 1, "rateMax": 10 } // [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
{ "rateMin": 0, "rateMax": 10, "rateStep": 2 } // [ 0, 2, 4, 6, 8, 10 ]
{ "rateMin": 0, "rateCount": 6, "rateStep": 20 } // [ 0, 20, 40, 60, 80, 100 ]
```

If you want to define specific rate scale values, set them in the [`rateValues`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateValues) array. It can contain numbers or objects with the `value` and `text` properties. Note that the `rateValues` array overrides the auto-generation properties described above.

## Use Star or Smiley Face Rating Scale

SurveyJS Rating Scale question enables you to represent scale values using graphical symbols, such as stars or smiley faces. A star rating scale offers respondents a series of stars to rate your service or product. Set the [`rateType`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateType) property to `"stars"` to activate this scale type.

A smiley face rating scale uses two to ten emojis to help your customers convey their feelings about your product. To display smileys as scale values, set the `rateType` property to `"smileys"`. Depending on the [`scaleColorMode`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#scaleColorMode) property value, smileys can be monochrome (default) or colored. You can also set the [`rateColorMode`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateColorMode) property to specify the color of the selected emoji: `"default"` to use the default survey color or `"scale"` to inherit the color from the scale.

## Files

### `public/index.html`

```html
<div id="app" style="position: absolute; top: 0; left: 0; right: 0; bottom: 0; height:100%"></div>
```

### `src/App.vue`

```html
<template>
    <SurveyComponent :model="survey" />
</template>
<script setup lang="ts">
    import { Model } from "survey-core";
    import { SurveyComponent } from "survey-vue3-ui";
    import "survey-core/survey-core.min.css";
    import "./index.css";
    import { json } from "./json";

    const survey = new Model(json);
    survey.onComplete.add((sender, options) => {
        console.log(JSON.stringify(sender.data, null, 3));
    });
</script>
```

### `src/index.css`

```css
/* You can add your custom CSS here. */
```

### `src/json.ts`

```ts
export const json = {
  "pages": [
    {
      "name": "page1",
      "elements": [
        {
          "type": "rating",
          "name": "satisfaction-numeric",
          "title": "How satisfied are you with our product?",
          "description": "Numeric rating scale",
          "rateValues": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
        },
        {
          "type": "rating",
          "name": "satisfaction-stars",
          "title": "How satisfied are you with our product?",
          "description": "Star rating scale",
          "rateType": "stars",
          "rateCount": 10,
          "rateMax": 10,
          "displayMode": "buttons"
        },
        {
          "type": "rating",
          "name": "satisfaction-smileys-monochrome",
          "title": "How satisfied are you with our product?",
          "description": "Smiley rating with monochrome scale",
          "rateType": "smileys",
          "rateCount": 10,
          "rateMax": 10,
          "displayMode": "buttons"
        },
        {
          "type": "rating",
          "name": "satisfaction-smileys-colored",
          "title": "How satisfied are you with our product?",
          "description": "Smiley rating with colored scale",
          "rateType": "smileys",
          "scaleColorMode": "colored",
          "rateCount": 10,
          "rateMax": 10,
          "displayMode": "buttons"
        }
      ]
    }
  ]
};
```

### `src/main.ts`

```ts
import { createApp } from "vue";
import App from "./App.vue";

const app = createApp(App);
app.mount("#app");
```

### `src/shims-vue.d.ts`

```ts
/* eslint-disable */
declare module "*.vue" {
    import type { DefineComponent } from "vue"
    const component: DefineComponent<{}, {}, any>
    export default component
}
```

### `src/theme.ts`

```ts
export const themeJson = {};
```

### `.eslintrc.js`

```js
module.exports = {
    root: true,
    env: {
        node: true
    },
    extends: [
        "plugin:vue/vue3-essential",
        "eslint:recommended",
        "@vue/typescript/recommended",
        "@vue/prettier",
        "@vue/prettier/@typescript-eslint"
    ],
    parserOptions: {
        ecmaVersion: 2020
    },
    rules: {
        "no-console": process.env.NODE_ENV === "production" ? "warn" : "off",
        "no-debugger": process.env.NODE_ENV === "production" ? "warn" : "off"
    },
    overrides: [
        {
            files: [
                "**/__tests__/*.{j,t}s?(x)",
                "**/tests/unit/**/*.spec.{j,t}s?(x)"
            ],
            env: {
                jest: true
            }
        }
    ]
};
```

### `babel.config.js`

```js
module.exports = {
  presets: ["@vue/cli-plugin-babel/preset"]
};
```

### `package.json`

```json
{
  "name": "surveyjs-library-vue3",
  "version": "0.1.0",
  "scripts": {
    "serve": "vue-cli-service serve",
    "build": "vue-cli-service build",
    "lint": "vue-cli-service lint"
  },
  "dependencies": {
    "core-js": "^3.6.5",
    "tslib": "2.6.1",
    "vue": "^3.4.1",
    "survey-core": "latest",
    "survey-vue3-ui": "latest",
    "vue-router": "^4.0.0-0",
    "vuex": "^4.0.0-0"
  },
  "devDependencies": {
    "@typescript-eslint/eslint-plugin": "^2.33.0",
    "@typescript-eslint/parser": "^2.33.0",
    "@vue/cli-plugin-babel": "~4.5.0",
    "@vue/cli-plugin-eslint": "~4.5.0",
    "@vue/cli-plugin-pwa": "~4.5.0",
    "@vue/cli-plugin-router": "~4.5.0",
    "@vue/cli-plugin-typescript": "~4.5.0",
    "@vue/cli-plugin-vuex": "~4.5.0",
    "@vue/cli-service": "~4.5.0",
    "@vue/compiler-sfc": "^3.0.0",
    "@vue/eslint-config-prettier": "^6.0.0",
    "@vue/eslint-config-typescript": "^5.0.2",
    "@vue/test-utils": "^2.0.0-0",
    "eslint": "^6.7.2",
    "eslint-plugin-prettier": "^3.1.3",
    "eslint-plugin-vue": "^7.0.0-0",
    "node-sass": "^4.12.0",
    "prettier": "^1.19.1",
    "sass-loader": "^8.0.2",
    "typescript": "~3.9.3"
  }
}
```

### `tsconfig.json`

```json
{
  "compilerOptions": {
    "target": "esnext",
    "module": "esnext",
    "strict": true,
    "jsx": "preserve",
    "importHelpers": true,
    "moduleResolution": "node",
    "skipLibCheck": true,
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "sourceMap": true,
    "baseUrl": ".",
    "types": [
      "webpack-env",
      "jest"
    ],
    "paths": {
      "@/*": [
        "src/*"
      ]
    },
    "lib": [
      "esnext",
      "dom",
      "dom.iterable",
      "scripthost"
    ]
  },
  "include": [
    "src/**/*.ts",
    "src/**/*.tsx",
    "src/**/*.vue",
    "tests/**/*.ts",
    "tests/**/*.tsx"
  ],
  "exclude": [
    "node_modules"
  ]
}
```

## Other Frameworks

- [Angular](https://surveyjs.io/form-library/examples/rating-scale/angular.md)
- [React](https://surveyjs.io/form-library/examples/rating-scale/reactjs.md)
- [jQuery](https://surveyjs.io/form-library/examples/rating-scale/jquery.md)
- [Vanilla JS](https://surveyjs.io/form-library/examples/rating-scale/vanillajs.md)