Skip to content

Routes Management

The module provides an admin interface for managing Prismic routes under Content > PrismicIO > Routes.

Accessing Routes

  1. Log into your Magento admin panel
  2. Navigate to Content > PrismicIO > Routes
  3. Here you can view and manage all Prismic routes

Managing Routes

Creating a Route

  1. Click "Add New Route"
  2. Fill in the required fields:
  3. Title: For admin reference
  4. Content Type: The Prismic content type (e.g., blog_post)
  5. Route: The URL path (must start with /, e.g., /blog)
  6. Store View: Select which store views this route applies to

Editing Routes

  1. Find the route in the grid
  2. Click "Edit" in the Action column
  3. Modify the route settings
  4. Click "Save Route"

Route Settings

  • Title: Internal reference name
  • Content Type: Matches your Prismic custom type
  • Route: URL path pattern
  • Store Views: Which stores show this content
  • Status: Enable/disable the route

URL Structure

Routes define how Prismic content is accessed on your store:

/{route}/{uid}
Example: /blog/summer-fashion-trends

Best Practices

  1. URL Structure
  2. Use clear, descriptive paths
  3. Keep URLs SEO-friendly

  4. Consider multi-store impacts

  5. Content Types

  6. Match Prismic custom types exactly
  7. One route per content type per store

  8. Consider language variations

  9. Store Views

  10. Assign routes appropriately
  11. Consider URL conflicts
  12. Plan for translations

Troubleshooting

  1. 404 Errors
  2. Verify route is enabled
  3. Check store view assignment

  4. Confirm content type exists

  5. URL Conflicts

  6. Check for duplicate routes
  7. Review store view assignments

  8. Verify URL patterns

  9. Content Not Showing

  10. Validate content type name
  11. Check store view settings
  12. Review route status