What is a Synced Widget?
A Synced Widget is essentially a Saved Widget, only with the added capability to sync updates made on that Saved Widget across all the Templates and Pods where it is being used. Creating and syncing a Widget is a great way to apply an update to certain content without having to go into every Pod and Template that contains that Widget. This becomes particularly handy for central pieces of content where updates must be uniform across the board.
How do I create and use a Synced Widget?
You can create and edit a Synced Widget from the Template Editor of a new or an existing Template. A Saved Widget can be made into a Synced Widget in two ways:
1. Creating a Widget from scratch and saving as Synced.
2. Updating an existing Saved Widget as Synced.
To save a Widget as Synced:
Inside a Template, add any Widget that you want to sync.
Start editing the Widget.
Once done, hover over the toolbar on the side and click on the Save icon.
This will open the Save Widget modal. Add a name under “Saved widget name”.
Select “Convert this saved widget to a synced widget.”
Click “Create Saved Widget.”
To create a Synced Widget from an existing Saved Widget:
Inside a Template, go to the Widgets menu. Select the “Saved” widgets view.
Find the Saved Widget you want to convert and click on the cog icon on that Saved Widget.
On the Settings modal, make sure to select “Convert this saved widget to a synced widget.”
Click “Save” and that should convert that Saved Widget into a Synced Widget.
As you can see, when “Convert this saved widget to a synced widget” is selected, saving or updating the Widget will convert it to a Synced Widget.
Note: When a Synced Widget is created this way, the sync updates on that Synced Widget will not apply retrospectively. i.e., Any instances where this Widget was used prior to being converted will not be synced.
Identifying a Synced Widget
You will see that a Widget is synced when:
This icon can be seen beside the Widget Title on the Saved Widgets view.
Hovering over a Widget on a Template and an overlay appears. There will be a note that will say it’s a Synced Widget, as seen below:
Template level updates to a Synced Widget
When making changes to a Synced Widget in a Template, you have the ability to push those updates across or disable these updates so the change will only apply to that local Widget.
Pushing updates to a Synced Widget
In the Template Editor, go to the Synced Widget you want to update.
Hover over the Synced Widget to see the prompt “This is a synced widget.” Click “Continue and Edit” and make the necessary changes.
On edit mode of a Synced Widget, find the Status Bar at the top where you can click “Done” and “Sync”.
To sync all changes made across all instances of that Synced Widget, click “Sync”. On the "Sync updates" modal, click "Sync" and a confirmation message will appear indicating "Saved widget updates have been synced".
This will push updates across all instances of this Synced Widget.
Unsynced updates on a Synced Widget
When editing a Synced Widget, clicking “Done” on the Status Bar at the top will keep the updates locally within the Template.
Once done, a prompt will appear indicating “Synced widget has un-synced changes”.
When exiting a Template that has a Synced Widget with un-synced updates, a prompt will appear asking to:
Leave Template
Sync Updates
If you select “Leave Template”, any changes made on that Synced Widget will remain locally within that Template.
Going forward, any changes made to that Widget will not be sent through to the connected Synced Widgets, unless a user resumes the sync.
Resuming updates on a Synced Widget
To resume updates on a Synced Widget with un-synced updates:
Simply go into a Template and find the Synced Widget where you need to resume updates.
In the example below, we are going into the Template used in the preceding section. On this Template, we have previously selected "Leave Template" instead of "Sync Updates".
Instantly you will receive a prompt where you can choose to “Leave Template” or “Sync Updates”. This prompt will include the number of Pods and Templates that contain Synced Widgets linked to the Synced Widget in the Template.
When resuming updates across all the Synced Widgets on that Template, simply click on “Sync Updates”.
When resuming updates on one particular Synced Widget that has un-synced changes, exit out of this prompt.
Go to the Synced Widget with un-synced changes.
As above, click “Continue and Edit” on the prompt that will appear on this Synced Widget.
In edit mode of the Synced Widget, click “Sync” once you’re done making any changes. On the "Sync updates" modal, click "Sync" and a confirmation message will appear indicating "Saved widget updates have been synced".
This will push updates across all instances of this Synced Widget.
Pod level updates to a Synced Widget
Note: Any updates made to a Synced Widget inside a Pod will disconnect that widget from the link.
To disconnect a Synced Widget in your Pod:
In the Pod Editor, go to the Synced Widget you wish to disconnect.
Hover over the Synced Widget to see a prompt. Click “Continue and Edit”.
Once clicked, a note will appear confirming that the Widget is no longer synced.
