Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update library unsyncing #7325

Open
wants to merge 2 commits into
base: develop
Choose a base branch
from
Open

Update library unsyncing #7325

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7a65e37
Update library unsyncing
vanand17 Dec 16, 2024
d86af5f
Update libraries.md
prigiattiperrut Jan 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 12 additions & 1 deletion src/protocols/tracking-plan/libraries.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,18 @@ When you import events or properties from a Library, you can enable syncing to e

To enable syncing, select the desired Library from the Tracking Plan import flow, and toggle the syncing option. This selects all events or properties in the Library for import. Partial syncs are not supported.

Syncing a Library makes events and properties un-editable, and bypasses the Tracking Plan merge step. You can add properties to synced events, but cannot remove those synced events unless you also remove the Library sync. To unsync a library, click **View Synced Libraries** from the Tracking Plan and click the overflow menu to unsync the Library.
Syncing a Library makes events and properties un-editable, and bypasses the Tracking Plan merge step. You can add properties to synced events, but cannot remove those synced events unless you also remove the Library sync.

### Library unsyncing
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@prigiattiperrut @vanand17 - does the term "unsync" appear in the app anywhere?


To unsync a library, click **View Synced Libraries** from the Tracking Plan and click the overflow menu to unsync the Library.
However, please note that when a property or a event library is unsynced from a tracking Plan, it will not remove the properties and events synced via the library, instead, it will chnage the source of the event or the property as 'Manually Added'. From here, you can select the events and proeprties to manaully delete them.

![Screenshots of event properties that was synced via a library, however after unsycing the event library, the following images shows how the event appears in the tracking plan before and after](![image](https://github.com/user-attachments/assets/09f2e4dd-a988-414a-9333-343cc915474c)
![after un-syncing, they appear as 'Manually Added',](https://segment.zendesk.com/attachments/token/g5zAeCdyxxmj6xeDHUtMRu5fw/?name=image.png)
)

**Note**: You cannot resync the same property/event library until the manually added properties and events are deleted from the Tracking Plan. This is because the existing properties/events (now marked as "Manually Added") conflict with the resync attempt.

> warning ""
> All changes made to a synced library pass through to the Tracking Plans and may impact data deliverability
Expand Down