Skip to main content
#2-way-sync

Sync Back

Sync Back sends your prioritization scores and voting results from Ducalis to GitHub custom fields. This keeps your GitHub projects updated with the latest priority rankings.

There are two ways to create fields in GitHub:

  • Automatically (recommended). Just turn on the back sync, and fields will be created automatically in GitHub. No manual creation is needed.
  • Manually. Create fields in GitHub, add them to all projects, and map them in Ducalis.
Recommended approach

Use automatic field creation. Ducalis creates the necessary custom fields in GitHub for you—no manual setup required.

Access Sync Back settings​

  1. Go to Backlog Management section.

    Backlog Management section location

  2. Scroll down to Sync Back Fields.

    Sync Back Fields section

Method 1: Automatic field creation​

Automatic field creation is enabled by default.

Prerequisites

Your GitHub issues must be added to a GitHub project. Projects have custom fields that Ducalis uses to sync data.

Automatic field creation toggle

Choose fields to sync​

  1. Select which Ducalis fields you want to sync to GitHub.

    By default, you'll see two fields: Priority {emoji} Ducalis and Alignment {emoji} Ducalis.

    Default sync fields

  2. Click Add Sync Back Field to sync additional data from Ducalis to GitHub.

    Add Sync Back Field button

  3. To remove a field, hover over it and click the Remove button.

    Remove field button location

Activate Sync Back​

  1. Switch on the toggle to activate sync.

    Toggle to activate sync

  2. Custom fields are automatically created in the GitHub project you selected during import configuration.

    Custom fields created in GitHub

  3. The emoji in custom field names represents your Ducalis Board ID. You can change it in your board settings. After changing the emoji, turn sync off and on again to apply the change.

    Board ID emoji in field name
warning

After activating sync, you can't add more fields. To add fields, turn sync off first, add your fields, then turn it back on.

Method 2: Manual field creation​

Turn off automatic field creation to use manual mapping.

Manual field creation option

Create custom fields in GitHub​

  1. In your GitHub project, go to Settings and choose Custom Fields.

    GitHub Custom Fields settings

  2. Create the custom fields you need.

    Create custom field in GitHub

  3. Configure the field:

    • Enter a field name.
    • Choose the field type. Check the field type in Ducalis first to ensure they match. For example, if you want to map the Ducalis field "Evaluation Progress" to GitHub, check its type in Ducalis and select the same type in GitHub.
    Field type selection

  4. Return to Ducalis and click Refresh.

    Refresh button in field mapping

  5. The field appears in the dropdown. Select it and click Save.

    Select and save mapped field

Activate Sync Back​

Ensure there are no unmapped fields (shown in red) before activating sync. Delete any unmapped fields you don't need.

Switch on the toggle to activate sync.

Activate manual sync

The field and its data now appear in GitHub.

Synced field in GitHub

Sync schedule​

Sync Back runs automatically once a week or on your custom schedule.

  1. Choose the day and time to sync data to GitHub. For example, schedule it a few days before your sprint planning meeting.

    Schedule sync settings

  2. To sync immediately, click Manual Sync with GitHub.

    Manual sync button

Copy schedule to other boards​

You can copy sync schedule settings to multiple boards at once.

  1. Click Copy sync schedule settings.

    Copy schedule settings button

  2. Select the boards you want to copy settings to.

    Select target boards

  3. Click Copy Settings.

    Confirm copy settings
Last updated: Jan 6, 2026