## Global Drops ### site **Available in**: All contexts **Properties**: ```liquid {{ site.id }} {{ site.name }} {{ site.url }} {{ site.host }} {{ site.description }} {{ site.default_locale }} {{ site.locales }} {{ site.logo }} {{ site.favicon }} ``` **Example**: ```liquid {{ page.title }} - {{ site.name }} ``` ### html5 **Available in**: Layouts only **Methods**: ```liquid {{ html5.open_tag }} {{ html5.close_tag }} ``` **Example**: ```liquid {{ html5.open_tag }} ... ... {{ html5.close_tag }} ``` ### csp_nonce **Available in**: All contexts **Purpose**: Content Security Policy nonce for inline scripts/styles ```liquid {{ 'root' | asset_url: 'css' | stylesheet_tag: nonce: csp_nonce }} {{ 'app' | asset_url: 'js' | script_tag: nonce: csp_nonce }} ``` --- ## Page-Specific Drops ### page **Available in**: All contexts **Properties**: ```liquid {{ page.id }} {{ page.name }} {{ page.title }} {{ page.path }} {{ page.excerpt }} {{ page.meta_tags }} {{ page.grid_type }} {{ page.widgets }} {{ page.has_router }} {{ page.page_type }} ``` **Example**: ```liquid

{{ page.title }}

{% if page.excerpt %}

{{ page.excerpt }}

{% endif %}
{{ content_for_layout }}
{% if page.meta_tags.description %} {% endif %}
``` ### page_grid **Available in**: Grid snippets only **Structure**: Object with columns matching grid type **Example** (in `full_three_cols_grid` snippet): ```liquid
{% for widget in page_grid.column_0 %} {% snippet widget %} {% endfor %}
{% for widget in page_grid.column_1 %} {% snippet widget %} {% endfor %}
{% for widget in page_grid.column_2 %} {% snippet widget %} {% endfor %}
``` --- ## Content Drops ### spaces **Available in**: All contexts **Purpose**: Access published content from Content API **Structure**: ```liquid {{ spaces['space_uid'] }} {{ spaces['space_uid'].types['type_uid'] }} {{ spaces['space_uid'].types['type_uid'].entries }} ``` **Space Properties**: ```liquid {{ spaces['blog'].name }} {{ spaces['blog'].slug }} {{ spaces['blog'].url }} ``` **Type Properties**: ```liquid {{ spaces['blog'].types['post'].name }} {{ spaces['blog'].types['post'].slug }} {{ spaces['blog'].types['post'].single }} ``` **Example**: ```liquid {% assign posts = spaces['blog'].types['post'].entries %}
{% for post in posts %}

{{ post.fields['Title'] }}

{{ post.fields['Excerpt'] }}

Read More
{% endfor %}
``` ### entries **Available in**: Content page index templates only **Purpose**: All entries of content type for current page ```liquid

All Blog Posts

{% for entry in entries %}

{{ entry.fields['Title'] }}

{% endfor %} ``` ### entry **Available in**: Content page show templates only **Purpose**: Single entry accessed by slug ```liquid

{{ entry.fields['Title'] }}

{{ entry.fields['Body'] }}
Published
{{ entry.published_at | date: "%B %d, %Y" }}
Last Updated
{{ entry.updated_at | date: "%B %d, %Y" }}
Author
{{ entry.fields['Author Name'] }}
{% if entry.fields['Related Products'] %}

Related Products

{% for product_id in entry.fields['Related Products'] %} {% assign product = spaces['catalog'].types['product'].entries | by_id: product_id %} {{ product.fields['Name'] }} {% endfor %} {% endif %}
``` **Entry Properties**: ```liquid {{ entry.id }} {{ entry.uuid }} {{ entry.slug }} {{ entry.name }} {{ entry.excerpt }} {{ entry.meta }} {{ entry.tags }} {{ entry.category }} {{ entry.published_at }} {{ entry.updated_at }} {{ entry.fields }} ``` **Critical: Field Access Notation** ⚠️ **MUST use bracket notation with exact field names**: ```liquid {{ entry.fields['Product Name'] }} {{ entry.fields['Price'] }} {{ entry.fields['SKU'] }} {{ entry.fields.product_name }} {{ entry.fields.price }} {{ entry.fields.sku }} ``` **See**: [LIQUID_BEST_PRACTICES.md](LIQUID_BEST_PRACTICES.md) for complete field notation guide. --- ## Navigation Drops ### menus **Available in**: All contexts **Purpose**: Access published navigation menus **Structure**: ```liquid {{ menus['menu_slug'] }} {{ menus['menu_slug'].items }} ``` **Menu Properties**: ```liquid {{ menus['main-nav'].name }} {{ menus['main-nav'].slug }} {{ menus['main-nav'].items }} ``` **Menu Item Properties**: ```liquid {{ item.id }} {{ item.label }} {{ item.url }} {{ item.target }} {{ item.visible }} {{ item.parent_id }} {{ item.position }} {{ item.children }} ``` **Example - Simple Menu**: ```liquid ``` **Example - Nested Menu**: ```liquid ``` **Critical: Always Filter by Visibility** ```liquid {% for item in menus['footer'].items | visible_items %} {% for item in menus['footer'].items %} ``` --- ## User & Session Drops ### user **Available in**: Layouts, snippets, pages, widgets (**NOT CSS/JS templates**) **Purpose**: Currently authenticated user > **Note**: In Modyo Liquid, the drop name is `user`, not `current_user`. Check authentication with `{% if user %}` — NOT `{% if user.logged_in %}` (does not exist). **Properties**: ```liquid {{ user.id }} {{ user.name }} {{ user.first_name }} {{ user.last_name }} {{ user.email }} {{ user.username }} {{ user.avatar.url }} {{ user.realm_default_avatar }} {{ user.tags }} {{ user.custom_fields }} {{ user.unread_notifications_count }} ``` **Initials pattern**: ```liquid {{ user.first_name | slice: 0 }}{{ user.last_name | slice: 0 }} ``` **Example**: ```liquid {% if user %}
{% if user.avatar.url != blank %} {{ user.name }} {% else %} {{ user.first_name | slice: 0 }}{{ user.last_name | slice: 0 }} {% endif %} Welcome, {{ user.first_name }}
{% elsif site.login_enabled %}
Login Sign Up
{% endif %} ``` **Login/Logout URLs**: - Login: `{{ site.url }}/login` - Logout: `{{ site.url }}/logout` - Register: `{{ site.url }}/register` **Site properties**: - `site.login_enabled` — whether login is enabled for the site (use for conditional login links) **Session snippet**: Use `{% snippet "shared/general/session" %}` to include the built-in session management (handles login/logout flow, avatar, dropdown). ### session **Available in**: Layouts, snippets, pages, widgets (**NOT CSS/JS templates**) **Purpose**: Current user session **Properties**: ```liquid {{ session.authenticated }} {{ session.locale }} {{ session.segments }} ``` **Example**: ```liquid {% if session.authenticated %}

You are logged in

{% else %}

Please log in to continue

{% endif %} {% if session.segments contains "premium" %}
{% endif %} ``` --- ## Modyo-Specific Filters ### Asset Filters ```liquid {{ 'root' | asset_url: 'css' }} {{ 'app' | asset_url: 'js' }} {{ 'root' | asset_url: 'css' | stylesheet_tag: media: 'screen', nonce: csp_nonce }} {{ 'app' | asset_url: 'js' | script_tag: defer: 'defer', nonce: csp_nonce }} ``` ### Entry Filters ```liquid {{ spaces['blog'].types['post'].entries | by_slug: 'my-post' }} {{ spaces['blog'].types['post'].entries | by_uuid: '12345-67890' }} {{ spaces['blog'].types['post'].entries | by_id: 42 }} {{ spaces['blog'].types['post'].entries | by_category: 'news' }} {{ spaces['blog'].types['post'].entries | by_tag: 'featured' }} {{ spaces['blog'].types['post'].entries | order_by: 'published_at', 'desc' }} ``` ### Menu Filters ```liquid {{ menus['main-nav'].items | visible_items }} ``` ### Standard Liquid Filters ```liquid {{ text | upcase }} {{ text | downcase }} {{ text | capitalize }} {{ text | strip_html }} {{ text | truncate: 100 }} {{ price | money }} {{ number | plus: 10 }} {{ number | minus: 5 }} {{ number | times: 2 }} {{ number | divided_by: 3 }} {{ date | date: "%B %d, %Y" }} {{ date | date: "%Y-%m-%d" }} {{ array | size }} {{ array | first }} {{ array | last }} {{ array | join: ', ' }} {{ array | sort }} {{ array | uniq }} {{ text | url_encode }} {{ url | append: '?page=2' }} ``` --- ## Common Patterns ### Pattern 1: Conditional User Content ```liquid {% if user %}

Welcome back, {{ user.first_name }}

Logout
{% elsif site.login_enabled %}

Sign up today!

Get Started
{% endif %} ``` ### Pattern 2: Content Listing with Pagination ```liquid {% assign posts = spaces['blog'].types['post'].entries %} {% assign page_size = 10 %} {% assign page_num = request.params.page | default: 1 %} {% assign offset = page_num | minus: 1 | times: page_size %}
{% for post in posts limit: page_size offset: offset %}

{{ post.fields['Title'] }}

{{ post.fields['Excerpt'] }}

Read More
{% endfor %}
{% assign total_pages = posts.size | divided_by: page_size | ceil %} ``` ### Pattern 3: Multi-Language Content ```liquid {% case site.default_locale %} {% when 'es' %}

Bienvenido

{% when 'pt' %}

Bem-vindo

{% else %}

Welcome

{% endcase %} {{ 'welcome.title' | t }} ``` ### Pattern 4: Dynamic Navigation ```liquid ``` ### Pattern 5: Featured Content ```liquid {% assign featured = spaces['blog'].types['post'].entries | by_tag: 'featured' | limit: 3 %} {% if featured.size > 0 %}

Featured Posts

{% for post in featured %}

{{ post.fields['Title'] }}

{{ post.fields['Excerpt'] }}

{% endfor %}
{% else %} {% assign recent = spaces['blog'].types['post'].entries | order_by: 'published_at', 'desc' | limit: 3 %}

Recent Posts

{% for post in recent %}

{{ post.fields['Title'] }}

{% endfor %}
{% endif %} ``` --- ## Limitations ### CSS/JS Templates: No Private Drops **❌ These will FAIL in CSS/JS templates**: ```liquid /* CSS template - FAILS */ .user-name::after { content: "{{ user.name }}"; /* ERROR */ } // JS template - FAILS window.USER = { name: "{{ user.name }}", // ERROR authenticated: {{ session.authenticated }} // ERROR }; ``` **✅ Use server-rendered snippets instead**: ```liquid ``` ### Field Name Notation **❌ Dot notation doesn't work**: ```liquid {{ entry.fields.product_name }} {{ entry.fields.price }} ``` **✅ Bracket notation required**: ```liquid {{ entry.fields['Product Name'] }} {{ entry.fields['Price'] }} ``` ### Performance Considerations **❌ Avoid nested loops on large datasets**: ```liquid {% for post in spaces['blog'].types['post'].entries %} {% for comment in spaces['blog'].types['comment'].entries %} {% if comment.fields['Post ID'] == post.id %} {% endif %} {% endfor %} {% endfor %} ``` **✅ Use relationships or limit loops**: ```liquid {% assign posts = spaces['blog'].types['post'].entries | limit: 10 %} {% for post in posts %} {% assign comments = spaces['blog'].types['comment'].entries | by_post_id: post.id %} {% endfor %} ``` --- ## Best Practices ### 1. Always Check Existence ```liquid {{ entry.fields['Author'] }} {% if entry.fields['Author'] %} {{ entry.fields['Author'] }} {% endif %} ``` ### 2. Use Exact Field Names ```liquid {{ entry.fields['Product Name'] }} {{ entry.fields['SKU'] }} ``` ### 3. Filter Menu Visibility ```liquid {% for item in menus['main'].items | visible_items %} ``` ### 4. Provide Fallbacks ```liquid {% assign products = spaces['catalog'].types['product'].entries %} {% if products.size > 0 %} {% else %}

No products available

{% endif %} ``` ### 5. Use Semantic Variables ```liquid {% assign blog_posts = spaces['blog'].types['post'].entries %} {% assign featured_posts = blog_posts | by_tag: 'featured' %} {% assign recent_posts = blog_posts | order_by: 'published_at', 'desc' | limit: 5 %} ``` ### 6. Comment Complex Logic ```liquid {% comment %} Featured carousel: Shows up to 5 featured products. Falls back to recent products if no featured items. {% endcomment %} {% assign featured = spaces['catalog'].types['product'].entries | by_tag: 'featured' | limit: 5 %} {% if featured.size > 0 %} {% else %} {% endif %} ``` --- ## Summary **Key Takeaways**: 1. **Full Liquid**: Layouts, snippets, pages, widgets have ALL drops 2. **Partial Liquid**: CSS/JS templates have NO private drops (current_user, session) 3. **Field Access**: MUST use bracket notation with exact names 4. **Always Check**: Verify variable existence before use 5. **Filter Visibility**: Always use `visible_items` for menus 6. **Context Matters**: Different drops available in different templates **Quick Reference Table**: | Drop | Layouts | Pages | Widgets | CSS/JS | |------|---------|-------|---------|--------| | `site` | ✅ | ✅ | ✅ | ✅ | | `page` | ✅ | ✅ | ✅ | ✅ | | `spaces` | ✅ | ✅ | ✅ | ✅ | | `menus` | ✅ | ✅ | ✅ | ✅ | | `user` | ✅ | ✅ | ✅ | ❌ | | `session` | ✅ | ✅ | ✅ | ❌ | | `entries` | ❌ | ✅ (index) | ❌ | ❌ | | `entry` | ❌ | ✅ (show) | ❌ | ❌ | | `variables` | ❌ | ❌ | ✅ | ❌ | --- **Document Version**: 1.0.0 **Last Updated**: 2025-01-20 **Related Docs**: [LIQUID_BEST_PRACTICES.md](LIQUID_BEST_PRACTICES.md), [CSS_ORGANIZATION.md](CSS_ORGANIZATION.md)