Select, modify, and create a data source
Most SXA renderings are designed for reusability and pull data from data source items or associated content. The content they display is not bound to the page on which they appear but is stored in data source items. When you add a rendering to a page, you can select an existing data source or create a new data source item. This gives you full control over the content architecture, naming conventions, and the level of reusability that you want.
Select or create associated content
When you add a reusable rendering to the page in the Experience Editor, the items available for selection depend on the rendering you selected, which prevents you from associating data source items that do not match the rendering's requirements.
You cannot select associated content for the following renderings: non-reusable renderings (such as Rich Text), renderings that are shared across the entire site (Login), renderings that display data from the current page (Page Content), and renderings that do not display any content (Divider).
To select associated content:
-
In the Experience Editor, from the Toolbox, drag a rendering that supports reusable content to the page.
-
In the Select the Associated Content dialog box, you have the following options to choose from:
Tab
Path
Description
Select Existing Content
Click an item
Click an item from a global or local folder directly and then click OK.
Rendering name (Current Site) Create
Adds and selects a new data source that you can use globally.
Click Rendering name (Current Site) and click Create. In the Insert item dialog box, click the place in the tree where you want to create the new data source, enter a name, and click OK.
Optionally, you can create a new folder for your data source.
Rendering name (Current Site) Copy to
Creates a copy of a data source.
Select the root item Rendering name (Current Site) and click Copy to copy the new data source. Select the place in the tree where you want to add a copy of the data source, enter a name for the copy, and click OK.
Data (Current Site) Create
Adds and selects a new data source that you can use locally.
Click Data (Current Site) and click Create. Enter a name for the new data source and click OK.
If you create the data source under the Page Data node it will be a local data source that is stored as a subitem of the page item. Any changes you make to local data sources will only affect the page you are working on. If you want to be able to reuse the data source and manage it globally, you must create the data source in the global folder.
ImportantWe recommend that you do not rename local data source items (<Page>/Data) manually. Changing the name of a local data source item can break the link with the component (because the links are stored as relative paths).
Data (Current Site) Copy to
Creates a copy of a data source that you can use locally. Select the root item, enter a name for the copy, and then click OK.
Page
Lets you use a page as a data source.
This option is available for renderings that take content from the current page such as Page Content, Page List, JSON content, and JSON list.
Search for Content
In the Search field, enter the keywords that characterize the items that you want to search for, or build a query.
Modify associated content
You might want to change an associated item after it is placed on a page. For example, if you need to replace an image on the page.
To modify associated content:
-
In the Experience Editor, on the rendering's floating toolbar, click Change associated content.
-
In the Select the Associated Content dialog box, select the item that you want to associate with the rendering and click OK.