# graphql-scalars

> A collection of scalar types not included in base GraphQL.

Latest version **2.0.0** (published 2026-08-20) · MIT license · 0 weekly downloads

## Install

```sh
npm install graphql-scalars
pnpm add graphql-scalars
yarn add graphql-scalars
bun add graphql-scalars
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2026-08-20 |
| First published | 2016-09-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=10 |
| Dependencies | 1 |
| Unpacked size | 577.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1931 |
| Maintainers | urigo, dotansimha, kamilkisiela, ardatan, theguild-bot |

## Links

- npm: https://www.npmjs.com/package/graphql-scalars
- Repository: https://github.com/Urigo/graphql-scalars
- Homepage: https://github.com/Urigo/graphql-scalars#readme
- Issues: https://github.com/Urigo/graphql-scalars/issues
- npm.io page: https://npm.io/package/graphql-scalars

## Dependencies (1)

- [tslib](https://npm.io/package/tslib.md) ^2.5.0

## Recent versions

- 2.0.0 (latest) — 2026-08-20
- 2.0.0-alpha-20260820091409-a965a7d0d85e7c10e04497ad78a8f5e013191f62 (alpha) — 2026-08-20
- 2.0.0-alpha-20260820084332-86d1265fd462ae907515a09f1ab4b134aedfb092 — 2026-08-20
- 2.0.0-alpha-20260820083706-73706fe7dd838f3eaeb137d3471bc9509441067e — 2026-08-20
- 2.0.0-alpha-20260819170445-863bc25818ac74ea1c7e8366b4b47abf72ed2f2a — 2026-08-19
- 1.26.0 — 2026-08-11
- 1.26.0-alpha-20260811135215-a7baf29d002e0dd70510936db6713bc8c770be0e — 2026-08-11
- 1.26.0-alpha-20260811134954-98d5d2aa10cef2e9f588a3a82d7e5e0deb5ee7e9 — 2026-08-11
- 1.25.0 — 2025-10-14
- 1.24.2 — 2025-03-19
- 1.24.2-alpha-20250319110749-a0473ef86134962dc0d8bdf10dcd69be4ecb3212 — 2025-03-19
- 1.24.2-alpha-20250319110547-80ecfb940691ffa00cf4829322ab40c78f47db03 — 2025-03-19
- 1.24.2-alpha-20250319105444-5c2581f8a432d059f327b3eafbbbd3b04922a3bb — 2025-03-19
- 1.24.1 — 2025-01-29
- 1.24.0 — 2024-11-28
- … 1608 more at https://npm.io/package/graphql-scalars/versions

## README

[![scalar](https://user-images.githubusercontent.com/25294569/63675022-87723c80-c7f0-11e9-87b9-22c78c9a17e2.gif)](https://www.graphql-scalars.dev)

[![npm version](https://badge.fury.io/js/graphql-scalars.svg)](https://badge.fury.io/js/graphql-scalars)
[![Discord Chat](https://img.shields.io/discord/625400653321076807)](https://discord.gg/xud7bH9)

> A library of custom GraphQL [scalar types](http://graphql.org/learn/schema/#scalar-types) for
> creating precise type-safe GraphQL schemas.

## Getting Started

Please refer to [our website](https://www.graphql-scalars.dev) for all the documentation related to
GraphQL Scalars

## Contributions

Contributions, issues and feature requests are very welcome. If you are using this package and fixed
a bug for yourself, please consider submitting a PR!

And if this is your first time contributing to this project, please do read our
[Contributor Workflow Guide](https://github.com/the-guild-org/Stack/blob/master/CONTRIBUTING.md)
before you get started off.

### Code of Conduct

Help us keep GraphQL Scalars open and inclusive. Please read and follow our
[Code of Conduct](https://github.com/the-guild-org/Stack/blob/master/CODE_OF_CONDUCT.md) as adopted
from [Contributor Covenant](https://www.contributor-covenant.org/)

## License

Released under the [MIT license](./LICENSE).

## Thanks

This library was originally published as `@okgrow/graphql-scalars`. It was created and maintained by
the company `ok-grow`. We, The Guild, took over the maintenance of that library
[later on](https://the-guild.dev/blog/taking-over-merge-graphql-schemas).

We also like to say thank you to [@adriano-di-giovanni](https://github.com/adriano-di-giovanni) for
being extremely generous and giving us the `graphql-scalars` name on npm which was previously owned
by his own [library](https://github.com/adriano-di-giovanni/graphql-scalars).

And thanks to [excitement-engineer](https://github.com/excitement-engineer) for
[graphql-iso-date](https://github.com/excitement-engineer/graphql-iso-date),
[stems](https://github.com/stems) for [graphql-bigint](https://github.com/stems/graphql-bigint),
[taion](https://github.com/taion) for
[graphql-type-json](https://github.com/taion/graphql-type-json),
[langpavel](https://github.com/langpavel) for
[GraphQLTimestamp.js](https://gist.github.com/langpavel/b30f3d507a47713b0c6e89016e4e9eb7),
[vespertilian](https://github.com/vespertilian) for Duration scalar,
[maxwellsmart84](https://github.com/maxwellsmart84) for `NonEmptyString` scalar

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