Set question tag

Question tags let you label questions with the same tag across different surveys when those questions are similar in nature. Later, related APIs can fetch all questions under a given tag for merged analysis or comparative analysis.

Tags are configured at the account level. If you use multiple sub-accounts, this works as an organization-level setup—there is only one tag system under each main account, shared by all sub-accounts.

Example use cases

A home-appliance brand's main account creates an enterprise template with three questions—gender, age range, and brand NPS—and tags them "Gender", "Age", and "Loyalty".

- Line A's survey admin uses the template, keeps those three questions, adds Line A questions, and publishes Survey A.

- Line B's survey admin does the same and publishes Survey B.

- Each line analyzes its own survey data independently.

- The enterprise data platform calls APIs to pull survey, response, and tag data; querying the "Gender" tag finds matching questions in Surveys A and B, merges the results, and outputs organization-level gender distribution.

Permissions

- System administrator: Can create tags, apply tags to questions, and remove tags.

Feature access

Question tags are account-level, but the current entry point is on each question in the editor:

1. Open the survey editor and select a question.

2. Click the "Set question tag" button on the question to open the tag panel.

A dedicated "Tag Management" area at the account level may be added later for centralized CRUD; for now, use the "Tags" button on questions.

Create, view, and manage tags

Create tags

1. On a question, click "Set question tag".

2. Choose "Add tags" to create tags individually or in batch.

View tags

When tagging a question, the panel lists all existing tags under the main account so you can reuse them.

Centralized management

Tags are account-scoped, but creation currently starts from questions. 

Apply and remove tags

Apply a tag

1. Open the tag panel on a question.

2. Select a tag, tap the green checkmark at the bottom-right of the tag, and confirm.

Remove a tag

1. Open the tag panel on a question.

2. Tap the gray checkmark at the bottom-right of the applied tag and confirm.

Copy surveys and tag sync

- Copying surveys between sub-accounts syncs all question tags on that survey.

- Using a survey from the enterprise template library syncs all question tags from the template.

Tag standard questions in enterprise templates (e.g., Gender, Age, Loyalty) so business lines stay aligned for cross-survey reporting.

Tag-related APIs

Open APIs let you pull tags and tagged questions for data platforms or third-party systems. Key capabilities:

- List all question tags under the account：https://api.surveymars.com/v1/question-tags

- Find all questions that use a specific tag：https://api.surveymars.com/v1/question-tags/{tag_id}/bindings

See the latest API documentation in the product help center for request parameters and examples.

Important notes

1. One tag system per main account—use consistent naming so sub-accounts and APIs stay aligned.

2. Only system administrators can create tags and apply or remove them; survey administrators should contact an admin to change tags.

3. Pre-tag reusable questions in enterprise templates before business lines adopt them.

4. UI labels may vary by product version; trust in-product copy if it differs from this article.

FAQs

Q: Are question tags the same as survey tags?
A: No. Question tags are applied to individual questions to identify similar items across surveys; the tag library lives under the main account.

Q: Can a sub-account create its own tag library?
A: No. Sub-accounts share the main account's single tag system.

Q: Why can't survey administrators apply tags?
A: By design, only system administrators can create tags and apply or remove them; survey administrators can view tags only.

Q: Are tags kept when I copy a survey?
A: Yes—copying between sub-accounts or using an enterprise template syncs question tags.

Q: How do I analyze data across surveys by tag?
A: Use the API to list questions for a tag, then merge or compare response data (e.g., organization-wide gender distribution).

Quick reference

- Question tags: mark similar questions across surveys for merge/compare analysis.

- Scope: one tag system per main account; shared by sub-accounts.

- Permissions: system admin manages tags; survey admin views only.

- Entry: "Tags" on a question; blue checkmark to apply, gray to remove.

- Copy/template sync keeps tags; use APIs for data-platform reporting.