Manual
CLI
API
Log in Get started free

Tags from Git tags

Save a tag in Continuous Translations whenever you push a tag to the linked repository.

When a project is linked to a GitHub or GitLab repository, Continuous Translations can make a tag for every Git tag you push. A release tagged v1.4.0 in Git then has a snapshot of the translations called v1.4.0, which you can pull again later with ct pull --tag v1.4.0.

Switch it on #

  1. Open Project settings → Repository. The project needs a linked repository.
  2. Under the repository, switch on Create a tag for every Git tag. It is saved straight away.

It is off by default, so pushing a tag never creates anything until you ask for it.

What happens #

  • A tag is saved from the main branch of the project, with the name of the Git tag. The branch is not the branch the Git tag points at.
  • A Git tag whose name isn’t a valid tag name (letters, numbers, ., _, - and /, at most 60 characters) is ignored.
  • If a tag with that name exists, nothing happens. Tags never change, so a Git tag that moves does not move the tag.
  • Deleting a Git tag does not delete the tag.
  • The tag shows no creator. A tag.created webhook is sent as for any tag.

Translations pushed with ct push before the Git tag arrives are part of the snapshot, so run ct push and, if you need the translations complete, check them before you tag.

GitHub #

GitHub sends the Create event for a pushed tag, and the GitHub App has to be subscribed to that event. GitHub sends no event when more than three tags are pushed at once, so push such tags one by one or create the tag with ct tag create.

GitLab #

The webhook that setup creates for a project listens for Tag push events. Projects that were set up before this existed have a webhook without it: open the project’s Settings → Webhooks in GitLab, edit the Continuous Translations webhook and switch on Tag push events.