Building quizzes with NoorQuiz

What is NoorQuiz

NoorQuiz is a quiz and survey builder for WordPress. You build quizzes visually in a dedicated dashboard, then drop them into any page with a shortcode or block. There's no separate app to log into and nothing to configure outside wp-admin.

A NoorQuiz quiz can be graded (a trivia challenge with right and wrong answers), scored (a personality or product-finder quiz that routes people to a result based on their total score), or purely a survey with no scoring at all. The same builder handles all three — you choose per quiz.

Installation

1. Upload the plugin. In wp-admin, go to Plugins → Add New → Upload Plugin and choose the NoorQuiz zip file, or upload the noorquiz folder to /wp-content/plugins/ via FTP/SFTP.
2. Activate it. From the Plugins screen, click Activate under NoorQuiz.
3. Open NoorQuiz. A new NoorQuiz item appears in the left-hand wp-admin menu, with Quizzes, Templates, and Settings underneath it.

No other plugin is required. NoorQuiz works on a default WordPress install.

Your first quiz

The fastest way to get a feel for NoorQuiz is to start from a template rather than a blank quiz — see Using a template. To start from scratch instead:

1. Go to Quizzes. Type a title into the New quiz title… field at the top and click Create Quiz.
2. You land in the Builder. This is where you'll spend most of your time — add questions on the left, configure design and results on the right.
3. Add a question, add a result, hit Publish. A quiz needs at least one question and one result before it's worth publishing (the built-in validation panel will tell you if something's missing).
4. Copy the shortcode shown at the top of the Builder and paste it into any post or page.

Building a quiz

The Builder screen

The Builder is a single screen split into a working area and a sidebar, so you can see a question and its downstream effects (design, logic, results) at the same time without switching tabs.

Toolbar

• Draft / Published — a draft quiz's shortcode won't render anything on the front end until you publish it.
• Show Preview — opens the quiz in a modal, rendered with the exact same code the public page uses. Nothing here is an approximation — if it looks right in preview, it looks right live.
• Save Quiz — saves everything: questions, design, logic, and results, in one action. Ctrl/Cmd + S does the same thing without touching the mouse.

Question types

NoorQuiz ships nine question types. Pick the type from the dropdown above the question list, or when adding a new question.

Choices & scoring

For any choice-based question (Single Choice, Multiple Choice, True/False, Dropdown, Image Choice), each option has:

• Label — what the quiz-taker sees.
• Value — the value stored for that answer. Keep these short and stable (e.g. yes/no) — logic rules and result score ranges are built against these values and totals.
• Correct — marks an option as the right answer for a graded quiz. Purely informational unless you also give it a score.
• Score — points added to the quiz-taker's total if they pick this option. Leave every option at 0 for a pure survey with no scoring.

Scoring is never sent to the browser. The correct answer, every option's score value, and each result's score range are matched entirely on the server when a quiz is submitted — so there's nothing in the page source a quiz-taker could inspect to find the right answer or reverse-engineer their result.

Conditional logic

A logic rule lets you skip or jump to a different question depending on a previous answer — for example, only asking a follow-up question if someone answered "Yes" to an earlier one.

Each rule has a source question, a comparison (equals, etc.) against a value, and a target question to jump to when the rule matches. Add rules from the Logic Rules panel in the Builder sidebar. Without any matching rule, a quiz simply moves to the next question in order.

Intro screen

Turn on Show an intro screen before the first question in the Intro Screen panel to add a welcome step: a title, description, optional cover image, and a Start button, shown before question 1.

Two reasons to use one:

• It sets expectations — what the quiz is, roughly how long it takes — before someone commits to answering.
• It gives you a cleaner read on engagement. With an intro screen on, a quiz only counts as started once someone actually clicks the button — not the moment the page loads.

Results

How results are matched

Every quiz needs at least one result, and exactly one result flagged as Use as default / fallback result. When a quiz-taker finishes:

1. Every answer's score is added up into one total.
2. Each result with a score range is checked in order. Give a result a Score min and/or Score max to have it match a specific range — leave a bound empty to leave that side unbounded.
3. If nothing matches, the default result is shown. This is also what a pure survey (with no scored questions at all) shows every time.

Result blocks

A result's page isn't fixed to a single layout. Under Result actions on any result, add one or more blocks, drag them into the order you want, and that result's page is built from exactly those blocks.

Also on every result: a Show the title, description, and image above checkbox. Leave it on for the usual title/description header above your blocks, or turn it off to build the result page entirely from blocks.

Design

Colors & tokens

The Primary color in the Design panel is the one control most quizzes need. Buttons, the progress bar, selected choices, and links all follow it automatically — there's no need to restyle each piece individually.

Backgrounds

Set Quiz Background to:

• Default — no background behind the card.
• Gradient — pick from eight built-in gradient presets.
• Image — upload or choose a cover image from your Media Library, with an optional dark overlay so text stays readable on top of it.

Custom CSS

For anything the Primary color and background presets don't cover, add plain CSS under NoorQuiz → Settings → Custom CSS. It applies to every quiz on the site.

.nq-btn--primary {
  border-radius: 4px;
}

.nq-result__title {
  font-family: Georgia, serif;
}

Two ways to target something:

• A class, like .nq-btn (any button), .nq-choice (an answer option), or .nq-result (the result card).
• A design token, like --noorquiz-color-primary or --noorquiz-color-border, for a change that should follow through to every component that already uses that token.

Templates

Using a template

NoorQuiz ships with a library of ready-made templates across six categories — Marketing, E-commerce, Education, Business, Entertainment, and Survey — each a complete, realistic quiz you can use as-is or adjust.

1. Browse by category on the Templates screen.
2. Click Preview to try the exact template before committing — this opens the same Live Preview used in the Builder.
3. Click Use this template to create a new, fully editable quiz from it. The original template is never modified — you get your own independent copy.

Publishing

Shortcode & block

Every quiz has a shortcode shown at the top of its Builder screen and on its card in the Quizzes list:

[noorquiz id="123"]

Paste it into any post, page, or widget area that supports shortcodes. If you'd rather work visually, search for the NoorQuiz block in the block editor's block inserter and choose your quiz from its settings.

Reporting

Results log

Click Results on any quiz's card to see every attempt: its status, score, matched result, and when it started. Click View answers on any row to see exactly what that person answered, question by question.

Click Delete on a row to permanently remove that one attempt — useful for clearing out your own test submissions before sharing analytics.

Analytics

Click Analytics on a quiz's card for an aggregate view: views, starts, completions, completion rate, average score, and a drop-off chart showing how many people answered each question — a quick way to spot exactly where a quiz loses people.

Click Refresh to pull the latest numbers without leaving the page.

Reference

Settings

Under NoorQuiz → Settings:

• Delete all quizzes and response data when the plugin is deleted — off by default, so uninstalling NoorQuiz never silently destroys your quizzes or attempt history. Turn it on only if you genuinely want a clean uninstall.
• Custom CSS — see Custom CSS above.

Frequently asked questions

Troubleshooting

The shortcode shows nothing on the page

Check the quiz's status in the Builder — a Draft quiz's shortcode intentionally renders nothing on the front end. Switch it to Published.

A question I added isn't showing up

Make sure you clicked Save Quiz (or Ctrl/Cmd+S) after adding it. The Builder doesn't autosave.

The quiz-taker lands on the wrong result

Check each result's Score min / Score max for gaps or overlaps, and confirm each option's Score value is what you expect — see How results are matched.

My Custom CSS doesn't seem to apply

Confirm you clicked Save Settings after entering it, and that the selector you're targeting actually exists on the element you mean — inspect the quiz in your browser's dev tools to confirm the class name.

Analytics numbers look off

If a quiz has an intro screen enabled, an attempt only counts as started once someone clicks the Start button — not the moment the page loads. Delete any of your own test attempts from the Results log before sharing real numbers with a client or stakeholder.