Push Category

Upload local preference categories and translations to a workspace. Reads categories_preferences.json and translation files from the input directory. By default, changes are committed immediately (--commit=true). You can pass --commit=false to push without committing, then commit later using the category commit command to make them live.

Syntax

suprsend category push [flags]

Flags

Flag	Description	Default
`-h, --help`	Show help for the command	–
`-c, --commit string`	Promote changes from draft to live after pushing (true/false)	`true`
`-m, --commit-message string`	Message describing the changes being committed	–
`-d, --dir string`	Directory containing category files	`./suprsend/category/`
`-j, --json string`	Categories (and optional translations) as a JSON object	–

Example

# Push categories from default directory
suprsend category push

# Push categories from custom directory
suprsend category push --dir categories

# Push categories to production workspace
suprsend category push --workspace production

# Push categories with commit message
suprsend category push --commit=true --commit-message "Update notification preferences"

# Push categories inline via JSON
suprsend category push --json '{"categories":{"root_categories":[...]}}'

# Push categories with translations inline
suprsend category push --json '{"categories":{"root_categories":[...]},"translations":{"es":{"sections":{},"categories":{}}}}'

Frequently Asked Questions

I have pushed my categories but don’t see the updated categories in live mode.

You can view detailed logs by enabling debug mode export DEBUG=true in your terminal. In most cases, this happens when an existing preference category is being overridden by the latest push and that category is already linked to a workflow. When this occurs, the changes cannot be committed to live mode.The updated categories will still appear in draft mode, but you’ll need to update or unlink the workflows before committing the changes live.

Getting Started with CLI

Updates and Versioning

Sync

Workflow

Template

Schema

Event

Preference Category

Translation

Syntax

Flags

Example

Frequently Asked Questions

​Syntax

​Flags

​Example

​Frequently Asked Questions

Syntax

Flags

Example

Frequently Asked Questions