Embed

Wording and language

Every word the widgets say is replaceable, and none of it is a translation file you have to keep in step with ours. Pass the strings you want in the language you want them in.

The text option

text merges over the widgets' own wording. Name only the keys you are changing; everything you leave out keeps its default, so a new key added in a later release arrives in English rather than as an empty label.

VoteFirst.init({
  project: 'your-project-slug',
  key: 'your-embed-key',
  locale: 'de-DE',
  text: {
    vote: 'Abstimmen',
    voted: 'Abgestimmt',
    votes: 'Stimmen',
    more: 'Mehr anzeigen',
    empty: 'Noch nichts hier',
    suggestTitle: 'Feature vorschlagen'
  }
});

Three of the strings carry a placeholder, which is replaced wherever you put it: {n} is a count of voters, {pct} is a whole number percentage, and {field} is the name of the field a form is complaining about.

Dates and numbers

locale takes a BCP 47 tag and decides how a release date and a vote count are written. Left out, both follow the reader's own browser, which is usually what you want on a public page and not what you want on a page that is only ever in one language.

VoteFirst.init({ project: '...', key: '...', locale: 'de-DE' });
// 17. Aug. 2026, and 1.204 rather than 1,204

A tag the reader's browser does not know falls back to a plain date rather than failing, so an unusual one costs nothing.

Every key

Grouped by where they appear. Anything not listed here is not a string the widgets say.

Shared

Cards and vote controls

Changelog

The two vocabularies below both reach this field. Releases filed before the newer names existed still carry the older pair, and rows of both kinds sit in the same project, so both are named here.

The request a card opens

Clicking a card opens that request in place of the board, with its counts, its progress and its thread. These are the words that view adds.

The comment thread

What a refusal says

A refused call is written for the visitor rather than for you. The server's own sentence names routes and headers and never reaches the page; this is what does. The console still gets the real one, and the error object carries the code your handler should branch on.

The two popups

Every key below exists twice, once with each prefix, so the suggestion form and the problem report form can say different things. Where the default is empty the line is not drawn at all until you give it something.

The same wording can be given to one popup instead of to every widget, which is what you want when two buttons on the same page open the same form for different reasons.

VoteFirst.suggest({
  trigger: '#suggest-btn',
  title: 'Tell us what to build',
  intro: 'We read all of these.',
  headingLabel: 'In one line',
  headingHint: 'Dark mode',
  descriptionLabel: 'Why it would help',
  descriptionHint: 'What you are doing when you need it',
  submitLabel: 'Send it',
  doneMessage: 'Got it. Thank you.'
});