Setting up content snippets

Content snippets in Power Pages are reusable pieces of content that you can place across multiple pages and components. These snippets help you avoid duplication, maintain consistency, and streamline content management. A content snippet can include text, HTML, images, or any other elements, and it can be dynamically inserted into a page using Liquid templates or other Power Pages functionalities.

In this detailed guide, we’ll walk you through the process of setting up content snippets, their best use cases, and how to manage them effectively.

---

1. What are Content Snippets in Power Pages?

A content snippet is a piece of reusable content that can be inserted into multiple locations across a Power Pages site. These snippets allow for efficient content management and ensure consistency, as you only need to update the content in one place, and all instances of the snippet across the site will be updated automatically.

Key Benefits:

• Centralized Content Management: Instead of manually updating multiple pages, you can edit one content snippet, and all references to it are updated.
• Consistency: Ensure the same text or image is used across different pages.
• Efficiency: Save time by reusing content, such as banners, disclaimers, footers, or legal text.
• Easy Maintenance: If a snippet needs to be modified, it’s easier to do so centrally rather than tracking each instance across pages.

---

2. Creating and Setting Up Content Snippets

Step 1: Navigate to Content Snippets in the Power Pages Admin Center

1. Log in to Power Pages or Portal Management App.
2. Go to Site Settings and find the Content Snippets section under the Content category.

Step 2: Create a New Content Snippet

1. In the Content Snippets section, click + New Content Snippet.
2. Fill in the necessary fields:
   • Name: Choose a clear, descriptive name for the snippet (e.g., “Footer Text” or “Disclaimer Banner”).
   • Content: This is where you add your reusable content (e.g., HTML code, text, or even Liquid code for dynamic content).
   Example of content: htmlCopyEdit<div class="footer-banner"> <p>© 2025 YourCompany. All rights reserved.</p> </div>
3. Save the snippet. You can now use this snippet across different pages.

---

3. Using Content Snippets in Web Pages

After creating a content snippet, it can be embedded in Web Pages using Liquid templates. Here’s how you can add a content snippet to a page.

Step 1: Add Snippet to a Web Page

1. Open the Web Pages section in the Power Pages Admin Center.
2. Edit the web page where you want the snippet to appear.
3. In the Web Page Content section, use Liquid code to reference the content snippet: Example Liquid code: liquidCopyEdit{% snippet 'Footer Text' %}
4. Save and publish the page. Now, the content snippet will be rendered on that page.

Step 2: Dynamic Insertion Based on Conditions

You can also conditionally insert content snippets based on user roles, languages, or any other conditions using Liquid.

Example of a conditional snippet insertion based on the user’s language:

{% if website.language.code == 'en' %}
  {% snippet 'Footer Text' %}
{% else %}
  {% snippet 'Alternate Footer Text' %}
{% endif %}

This allows for flexibility and helps provide tailored content for different user groups.

---

4. Managing and Editing Content Snippets

Managing and editing content snippets is simple, and any changes to a snippet automatically reflect wherever the snippet is used.

Step 1: Edit an Existing Snippet

1. Go to the Content Snippets section in the Power Pages Admin Center.
2. Find the snippet you want to edit (e.g., “Footer Text”).
3. Click on the snippet to edit its content.
4. Make the required changes (e.g., updating text, modifying HTML, etc.).
5. Save the changes.

Step 2: Delete or Archive Snippets

If a snippet is no longer needed, it can be deleted or archived.

1. In the Content Snippets list, select the snippet to delete.
2. Click Delete or Archive to remove or temporarily disable the snippet.

Note: Deleting a snippet removes it from all pages where it is used, so use this option with caution.

---

5. Best Practices for Using Content Snippets

1. Use Descriptive Naming

When naming snippets, choose clear and descriptive names. For example:

• “Contact Us Form Header”
• “Disclaimer Text”
• “Legal Notices”
• “Navigation Bar Custom HTML”

This helps future users of the site quickly understand the purpose of each snippet.

2. Avoid Over-Complicating Snippets

Content snippets are meant to be reusable blocks of content. Avoid adding too much business logic or conditional logic in a snippet. If you need more complex logic, consider using Liquid templates or external scripts.

3. Use Snippets for Static Content

Snippets are best used for static content like footers, headers, disclaimers, or legal texts. For more dynamic content (e.g., data-driven displays), use Entity Lists or Liquid templates.

4. Use Snippets for Repeated Content

Wherever content is repeated across multiple pages or sections, use snippets. For example, a banner or call-to-action that appears in the header or footer across multiple pages should be created as a snippet.

5. Plan for Translations

If you’re building a multilingual site, consider creating separate snippets for each language. This allows you to manage translations easily while keeping content consistent across the site.

---

6. Troubleshooting Common Issues with Content Snippets

Problem	Solution
Snippet not showing up	Ensure that the snippet is correctly referenced using Liquid code. Check if the page has been published.
Snippet content not updated	Clear your browser cache to ensure you’re seeing the latest version.
Liquid code error	Double-check syntax in the Liquid code to ensure proper referencing of the snippet.
Snippet not appearing for certain users	Verify if any conditional logic is causing the snippet to be hidden based on roles or permissions.

---

7. Advanced Use Cases for Content Snippets

1. Dynamic Content with Liquid

You can embed dynamic content into snippets using Liquid. For example, displaying a user’s name in the footer:

{% snippet 'Welcome Banner' %}
  <p>Welcome, {{ user.fullname }}!</p>
{% endsnippet %}

2. Snippets in Forms

Content snippets can be used within forms to display standard instructions, privacy policies, or terms and conditions.

{% snippet 'Terms and Conditions' %}

This helps maintain consistency in legal disclaimers and ensures users can always access the latest terms.