Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pnlight.app/llms.txt

Use this file to discover all available pages before exploring further.

Use this page when a server-driven UI placement does not render or actions do not work.

Placement does not render

Check:
  • The app requests the same placement ID that exists in Remote UI.
  • The placement is enabled.
  • The requested locale has a config.
  • The config JSON is valid.
  • The user has not already seen a placement configured as Show only once per user.

Requests increase but shown does not

This usually means PNLight received the request but did not return a displayable config. Common causes:
  • Placement disabled.
  • Missing locale config.
  • Attribution is required but not resolved yet.
  • Show-once rules suppress the placement for that user.

Actions do not work

Check your app action handler:
  • Handle the expected logId, path, or action value.
  • Read parameters defensively.
  • Provide a fallback for unknown actions.
Use debug mode for a placement while testing display rules. Turn it off before production traffic unless your team intentionally needs it.