Paragraphs
Create content using standard or custom paragraphs
Paragraphs are default building blocks used for two things:
- To act as containers for content on pages
- To act as anchors for paragraph apps
How they are ordered also typically defines the content structure on the page they are on.
In Visual Editor mode, paragraphs are outlined in green and placed inside a row:
In List View mode paragraphs are shown as white-coloured list items, either alone or under a row:
Like pages, paragraphs can be paired with an item type with additional fields for storing content or settings. In fact, almost all modern solutions (including Swift) use paragraphs with various types of item types added to create content.
When you add or edit a paragraph (from either List View or Visual Editor view) you will see a number of tabs with input fields and various settings. Each tab is described below.
Content
The Content-tab contains the fields used to add content to the paragraphs - which fields are available here depends on the paragraph type.
- A standard paragraph simply has a title field, a text field, an image selector, and some image settings.
- An item-based paragraph has a list of fields defined on the item type
This is a standard paragraph:
Basically, this is where you write text, select images, and use whichever settings are available to further style content, and then hit Save and close. To see some examples of different item-based paragraphs check out the Swift content columns and ecommerce columns.
Publication
The Publication-tab allows you to set a publication period and use accessibility settings to set e.g. Hide for mobiles
Advanced
The Advanced-tab contains various more, well, advanced settings.
If the paragraph is on a master website, i.e. website with a language layer, you can check Lock language versions to force-lock this paragraph on all language layers under this website.
Under the item settings section you can select a content type, this is the item type attached to this paragraph. If you change the content type of a paragraph you will lose the data added in the current item fields.
The Layout section allows you to do layout-related changes:
- You can select the template used to render content from this paragraph. You can see the currently active template in the info-bar, and on most designs you will only very rarely use this setting to override a default template.
- If this is a design with content placeholders you can manually move the paragraph to a different placeholder
App
The App-tab allows you to attach a paragraph app to the paragraph.
Apps are small content-modules which are used to e.g. render a product catalog, display a form, show a list of orders, and so one. Please note that this tab is only available on item-based paragraphs if Allow module attachment is set for the item type.