Branches

Feature currently available only for Beta-Test program

Introducing the new "Branches" feature

Are you ready to take your TMS experience to the next level? We are thrilled to introduce our latest feature: Branches. This powerful tool is designed to elevate your team’s efficiency, allowing multiple users to work simultaneously on the same project without stepping on each other's toes. Imagine a workspace where you can confidently make changes, test them in isolation, and merge them seamlessly—all while keeping your Main project intact. Let’s dive into what makes this feature a game-changer.

What is "Branches"?

Branches allow you to create a separate, partitioned work environment—a safe space where your work is your own. You can make changes without worrying about interrupting your colleagues’ progress. When you're ready, simply merge your work back into the Main project with confidence, knowing that everything aligns perfectly.

Key Benefits

• Work independently: No more waiting for colleagues to finish their tasks. With Branches, everyone can contribute simultaneously without conflicts.

• Reduce errors: By isolating changes, you can avoid the dreaded “unfinished work” being deployed to production. Test and validate your changes in a secure environment before merging.

• Streamlined merging: Our intuitive interface makes merging a breeze. View changes side-by-side with our diff checker, ensuring nothing slips through the cracks.

❤️ Why you’ll love Branches ❤️

Say goodbye to workflow interruptions!

Previously, if two users worked on the same account, their changes would overlap, leading to potential conflicts during container generation. This often resulted in errors that stalled the deployment process, or worse—unfinished work going live. With Branches, you’ll experience a smoother, more controlled workflow. Your team can now focus on what they do best, without the hassle of managing conflicting changes.

A seamless User Experience

• Visual indicators: It’s easy to know where you are. When you’re working on the Main (your actual web container), all menu elements are cherry red. Switch to a Branch, and everything turns blue, signaling that you’re in a safe zone to make changes.

• Effortless Branch creation: Whether you’re starting a new project, creating a new Branch is just a click away. Our intuitive panel guides you through the process, from naming your Branch to diving straight into editing.

• Real-time notifications: Stay updated with any changes made into the Main while you’re working on a Branch. You’ll receive a prompt with options to update your Branch or continue working—keeping you in control at all times.

Glossary

• Main: your usual container, considered as "parent" in a Branch context

• Branch: a duplication of your Main to work without impacting your Main configuration

• Merge: action to bring the modifications from your Branch live in your Main container

How it works ?

Branch Creation

To open the Branch creation UI use the button in the breadcrumb menu (identified as "Main" when you are on your regular container, or by the Branch name if your are in Branch context). The list of your branches will appears. Click on "Create new branch". Just define a Branch name, you can also add a description if needed, You can create up to 5 Branches for each container!

On save, you will redirected in your new Branch environment

Once your Branch is created, all changes you make are isolated to this environment. The blue color of the navigation elements shows you are in a Branch.

You can edit/modify any elements as if you where in a regular container.

Limitations

-Rules cannot be permanently deleted in a Branch, only "Archive" action is possible. -Old events formats (deprecated tc_events) cannot be deleted in a Branch

Be careful on your WebDatalayer modification(s), it may impact all your site

Branch Comparison with the Main

At any time you can have clear view of the work done on each Branch. Simply click on the link "See changes"

The "Comparison" pop in will appears:

You can unfold elements to get details

Existing Branch Edition

To access an existing Branch, click on "pen" icon. This pop in is also useful to go back to your Main container.

Edit/modify any elements as if you where in a regular container.

Branch Update

If your Branch is not up to date with the newest Main changes, you will see this warning message, inviting you to update your Branch

On click, the pop in "Update" will be displayed, a diff checker. You are allowed to keep or discard the changes. The checked items will be bring into your Branch. If you don't wish to update your Branch now, then click on cancel.

Be careful on items with the items with label "conflict" It means there is modification(s) on the Main and on the Branch too

By default they are unchecked. Take time to compare and choose if you wish to keep the modification from the Branch or from the Main

We recommend to bring all the changes from the Main into your Branch. If you refuse to update some elements, you may impact the Main container on merging.

Branch QA & Test

You can generate your Branch as a regular container.

When you’re ready, deploy your changes in your UAT environment, ensuring everything works flawlessly before merging.

There's a main difference for Branches containers at the deloy step: deployment on Production environment isn't allowed. That's why the deploy step has been renamed as "QA - Merge" in Branch context!

The UAT deployment option will push your Branch version on the UAT URL of the Main container.

It means that you can test your Branch directly on your UAT site without IT intervention.

You can also download your Branch version and use override to test it

Branch testing compatibility with our plugin is under development. It's coming soon!

Merge Branch

Ready to bring your changes into the main Branch? Use our “Merge” feature, where you can review the differences, see a detailed comparison, and complete the merge effortlessly.

Merge doesn't consider the generation versions. The UI for merging will ever display the latest updates of your Branch

If your Branch is not up to date, Merge will be blocked.

Take the time to update your Branch now with the latest Main changes!

After merge

Once you merged your Branch, the Branch will be deleted and you will be redirected to your Main

All modifications from Branches are now logged in your Main with [Branch*] prefix

At any time after merge, you can view all modifications logs from the merged Branch on your Main Modification History.

Don't forget to re-generate your Main container to bring your changes in Production!

Looking ahead

Future-Proof Your Workflow

Although direct production deployment from a Branch is not available, our new QA plugin (currently under development), will offer you another way of testing your Branches, even in a production environment.