### A simple plugin to generate random IDs for your documents in DatoCMS

(Image content)

[

**This is a Community Plugin!** Learn how create your own plugin, or copy and remix existing ones in our documentation

](https://www.datocms.com/docs/plugin-sdk/introduction.md)

## ID Generator DatoCMS plugin

A simple plugin to generate IDs for your documents in DatoCMS

## Configuration

To enable the random ID generator for your single-line text field, choose "ID Generator" as a field add-on.

(Image content)

When applying this plugin to your field you can set the following settings:

1.  ID prefix if you need it to add before generated IDs.
2.  The minimum length for your IDs, default is 3.
3.  Upper case option for generated ID to convert it to uppercase, default is true.
4.  Auto generation option, default is true.

(Image content)

## Using

The result of plugin working appears in the field:

(Image content)

Click on the link "Generate ..." generates random ID according to settings.

## Development

Install all the project dependencies with:

```plaintext
yarn install
```

Add this plugin in development mode to one of your DatoCMS project with:

```plaintext
yarn addToProject
```

Start the local development server with:

```plaintext
yarn start
```

The plugin will be served from <[http://localhost:5000/](http://localhost:5000/)\>. Insert this URL as the plugin [Entry point URL](https://www.datocms.com/docs/plugins/creating-a-new-plugin/.md).

## Publishing

Before publishing this plugin, make sure:

-   you've properly described any configuration parameters in this README file;
-   you've properly compiled this project's `package.json` following the [official rules](https://www.datocms.com/docs/plugins/publishing/.md);
-   you've added a cover image (`cover.png`) and a preview GIF (`preview.gif`) into the `docs` folder.

When everything's ready, just run:

```plaintext
yarn publish
```