Project history in Jitterbit Studio

Introduction

This page describes how to view project history, manage snapshots, and restore projects. Project history is stored for a maximum of 180 days. Snapshots remain available indefinitely. When you export a project, both the project history and snapshots are cleared from the exported version.

Access project history and snapshots

You can access the Project history drawer from the following locations:

• The design canvas (see Design canvas actions menu).
• The Projects page (see Tile view or List view).

The drawer contains two tabs:

• Project history: Shows a list of project changes and deployments. Each entry includes the date, time, and the user who performed each action.
• Snapshots: Shows a list of snapshots created automatically or manually.

View project history

Project history events are grouped by day in reverse chronological order. Each event is listed individually with its timestamp and shows the user's first name and last name initial. The day header displays a count of all change events for that day.

Filter history

The following controls are available to filter the history view:

• Search box: Enter a single keyword or keyword string. Only events containing the keyword string appear, and the keyword string is highlighted in blue.

  

• Timeframe menu: Select Last 30 days, Last 60 days, Last 90 days, or Last 180 days.

• Event type menu: Select which event types to display. The following options are available:

  • All events: Displays all project history events with any tags.
  • Deploys: Displays deployment events only.
  • Migrations: Displays full project transfers only.
  • Imports: Displays import events only.
  • Transfers: Displays selective transfer events only.
  • Tagged: Displays events that have been tagged.

View event details

To view or collapse event details, click the caret to expand or collapse all events for that day.

The following additional controls are available:

• Expand / Collapse all: Expands or collapses all event details at once.
• Restore last deployed version: Restores the project to the last deployment.
• Download as CSV: Downloads current filtered history data.

Event types

The following table describes each event type:

Detailed change information for scripts and transformations

For script and transformation components, detailed change information is shown by default:

The detailed changes may include the following:

• Script type changes (for example, "Script type was changed from JavaScript to Jitterbit Script").
• Script content changes (shown as "Script body was changed").
• Transformation mapping changes.
• Other direct configuration updates.

Manage snapshots

Snapshots capture your project state at specific points in time. Automatic snapshots are created during deployments, transfers, and imports. You can also create manual snapshots.

Create a manual snapshot

To create a snapshot, complete these steps:

1. Open the Snapshots tab in the project history drawer.

2. Click the Create snapshot icon.

3. The New snapshot dialog includes the following fields:

   

   • Tag: Enter a unique tag to label the snapshot (required).
   • Description: Enter an optional description.

4. Click Save.

Snapshots are stored indefinitely.

Filter snapshots

The following controls are available in the Snapshots tab:

• Search by tag: Enter tag names to find specific snapshots.

• Type menu: Filter by Automatic or Manual snapshots:

  • Automatic: Automatic snapshots are captured during these events:

    • Deployment: The project designer at the time of deployment.
    • Transfer or migration: The target project designer before the transfer or migration is applied.
    • Import: The project designer before the import is applied.

  • Manual: Snapshots created manually.

Tag events and snapshots

Transfer, deploy, and restore events can include tags and comments for versioning and organization.

Tag requirements

Transfer events must be tagged from the project transfer screen before the project can be transferred.

Deploy events can be configured to require tags or comments. To require tags or comments at deploy time, enable Require tags when deploying in the project setting's Deploy tab. When enabled, you see a dialog that requests the required tag or comment when you deploy the project.

Add or edit tags

To add or edit a tag, complete these steps:

1. Hover over the event or snapshot.

2. Click Details.

3. The dialog includes the following fields:

   

   • Tag: Enter a label (unique tag recommended but not required).

   • Comment (events) or Description (snapshots): Enter additional information.

4. Click Save.

You can edit tags and comments that you added. Tags and comments added by other users are view-only.

Restore a project

Project backups are automatically created when you transfer, deploy, or restore a project.

Restore to a specific version

To restore a project, complete these steps:

1. In the project history drawer, locate the event or snapshot you want to restore to.

2. Hover over the event or snapshot.

3. Click Restore this version.

4. In the confirmation dialog, click Restore.

The project designer reverts to the selected version. This action does not affect the deployed version. Redeploy the project to deploy the restored state.

Alternatively, you can restore your project to the last deployed version by using the Restore last deployed version icon (described above).

Restore corrupted projects

If a project is corrupted and cannot be opened, you can access the project history from the project's action menu on the Projects page and restore the project to an earlier state before corruption occurred.

Collaborate during restore

When multiple users work on the same project simultaneously and someone restores the project, the following occurs:

• An informational dialog appears for all active users.
• Closing the dialog updates their view to reflect the restored project state.

This behavior prevents unexpected changes to active work sessions without warning.