Troubleshooting

Policy Document Troubleshooting

Last updated March 5, 2026

Policy Document Troubleshooting

Policy Page Shows "Not Found"

Cause: The policy document has not been published, or no version has been set as current. Fix: 1. Go to Templates > Policy Templates and open the template 2. Ensure the template is saved with all required fields 3. Push the template to the target site 4. Enable Auto-publish during the push to make the policy live immediately

Placeholders Not Replaced

Symptom: The policy page shows [company_name] or [contact_email] instead of actual values. Cause: The corresponding answer fields were left empty in the template configuration. Fix: 1. Edit the policy template 2. Fill in the Company Information fields (company name, website URL, contact email, jurisdiction) 3. Save the template 4. Re-push to affected sites

Policy Page Styling Issues

Policy pages are rendered with clean, minimal styling. If the content looks wrong:
  • Ensure the content was pushed from a valid template (not an empty one)
  • Check that the template's doc_type matches the URL path (e.g., /p/{siteId}/privacy_policy)
  • Custom CSS on policy pages is not supported (they use LegalBanner's standard layout)

Updating a Published Policy

When you update a policy template and push again: 1. A new version is created for each affected site 2. The previous version is retained for audit purposes 3. If auto-publish is enabled, the new version becomes current immediately 4. If auto-publish is disabled, you need to manually publish the new version