THE ARYNOX FIELD GUIDE

A little guidance.
Endless possibilities.

From your first question to your next big insight. Clear instructions, real examples and inspiration for everything you create.

59 useful guides19 field typesOne beautiful workflow

Getting started / 01

Your first survey, from idea to insight

Start with one decision you want to make. A focused survey is easier to answer and easier to act on. You can start with a blank survey or adapt a template; neither becomes public just because you create it.

Demonstration screenshot · sample survey, no customer data. Select to enlarge. Controls can vary with plan, role and screen size.

Step by step

  1. Sign in and open Dashboard. Choose Create a survey, enter a clear title and choose the workspace. Or visit Template library and use a relevant starting point.

  2. In Build, add the questions you actually need. Use a short introduction to explain the purpose, expected effort and how responses will be used.

  3. Choose your privacy mode before collecting answers. Add required questions sparingly and check every conditional path.

  4. In Design & Branding, choose a theme and customise it. Add any translations in Languages, including the completion message.

  5. Use Preview to check your current edits. Save draft to keep private work, or Save & publish when ready. Check Collect and its test/live setting before distributing a link.

  6. Share through the appropriate link, invitation or QR code. Review Results, identify a useful action and communicate what you learned.

PUT IT INTO PRACTICE

A real-world example

A café wants to improve lunchtime visits: ask for a rating, the main reason for that rating and one improvement. Three relevant questions are more useful than twenty unrelated ones.

Good to know

  • Features and allowances depend on your plan and role. If a control is unavailable, check your subscription or ask your organisation owner.
Getting started / 02

Find your way around your workspace

Dashboard is your welcome page. All surveys remains the place to browse, search and manage your survey collection. The main portal navigation and the tabs inside a survey serve different purposes.

Step by step

  1. Use Dashboard for recent surveys, workspace totals and the response trend. The response chart covers the last 30 days and offers exact daily figures.

  2. Open All surveys to search by title and continue editing. Each survey has its own Build, Design & Branding, Collect, Results, Manage and Languages tabs.

  3. Use the main menu for account-wide tools: contacts, campaigns, analytics, branding, team settings and support, according to your permissions.

  4. Collapse the main menu when you want more editing room. On small screens, open the menu drawer; field settings adapt to the available space.

PUT IT INTO PRACTICE

A real-world example

A team member checks the dashboard on Monday, opens the latest customer survey and jumps directly to Results. A creator uses the same recent-survey card to continue editing.

Good to know

  • Dashboard totals belong to the active organisation. Switching accounts changes the workspace context.
  • Recorded response figures include retained test submissions. A published survey is not necessarily accepting responses: check Collect.
Getting started / 03

Write questions people want to answer

Good surveys use neutral language, a clear purpose and an answer format that matches the decision. Ask one thing at a time and avoid making respondents guess what you mean.

Step by step

  1. Replace leading questions such as “How excellent was our service?” with “How would you rate the service?”

  2. Split combined questions: speed and friendliness may deserve different answers. Specify a time period where it matters.

  3. Keep answer choices distinct. Add a relevant “Not applicable” option where respondents may have no experience.

  4. Put easy questions first, group related topics and leave optional comments near the end. Explain why sensitive information is needed.

  5. Pilot the survey with someone outside your team. Watch for confusing labels, missing choices and unnecessary required fields.

PUT IT INTO PRACTICE

A real-world example

For a training session, ask “How useful was today’s session?” followed by “What would make the next session more useful?” rather than asking whether the trainer was “engaging and informative”.

Good to know

  • A short survey is not automatically better; every question should earn its place.
  • Avoid asking for names or identifying details in an anonymous survey.
Build & logic / 04

Build, arrange and edit your questions

The Build workspace has a field palette on the left, your survey canvas in the middle and settings for the selected field on the right. This keeps the question and its controls close together.

Demonstration screenshot · sample survey, no customer data. Select to enlarge. Controls can vary with plan, role and screen size.

Step by step

  1. Choose a field from Add fields or search the palette. Click to insert it, or drag it to an insertion line on the canvas.

  2. Select a question to edit its label, help text, answer choices and applicable validation. Use the field type that matches the answer you need.

  3. Use drag handles or the provided move controls to reorder fields. Use Outline to navigate a longer survey.

  4. Use Undo and Redo for recent editing changes, and Collapse all or Expand all to control the canvas. Save your draft regularly.

  5. Open Survey settings for the overall introduction, privacy and submission limit. Open Completion message for the final heading and thank-you text.

PUT IT INTO PRACTICE

A real-world example

Build an event survey using Single choice for the session attended, Rating for usefulness and Long text for suggestions. Group the three under a section called “Your experience”.

Good to know

  • Selecting a field changes which settings appear. Content and layout elements do not collect answers.
Build & logic / 05

Required answers, validation and answer options

Field settings let you guide the answer without making the survey unnecessarily difficult. Options vary by field type; a text field and a multiple-choice field should not have the same controls.

Step by step

  1. Use Required answer only where an answer is necessary. A required question that does not apply to someone can stop them completing the survey.

  2. For choice fields, enter distinct options. Keep labels concise. Use selection limits on Multiple choice when a minimum or maximum number is needed.

  3. For text, choose an appropriate maximum length. For numeric fields, set meaningful minimum and maximum values.

  4. Where appropriate, randomise unordered choices to reduce ordering effects. Keep ordinal scales in their natural order.

  5. Use answer scores only with a defined interpretation. Test the full survey, including blank optional answers and values at the boundaries.

PUT IT INTO PRACTICE

A real-world example

A product team asks respondents to select up to three priorities from six features. A maximum of three selections encourages a useful trade-off.

Good to know

  • Choice options and matrix rows must be unique and nonempty. Choice questions need at least two options.
  • A required consent field needs an affirmative agreement to continue; consider whether that requirement is appropriate for your purpose.
Build & logic / 06

Show relevant questions with conditional logic

Conditional logic makes a survey more relevant by showing follow-ups only when earlier answers make them useful. A rule can reference an earlier question; it should not depend on a later answer.

Step by step

  1. Create the controlling question first, such as “Have you used our support service?” with Yes and No.

  2. Select the follow-up field and configure Show when using the earlier question, the available operator and the answer to match.

  3. Use End when only when a matching answer should end participation before that question. Write a clear survey introduction if eligibility is important.

  4. Keep dependencies in order when moving or deleting fields. Test every possible branch in Preview, including missing optional answers.

  5. For answer piping, use the supported earlier-question reference in a label, such as {{first_name}} when that is the actual question ID. Check the resulting wording in Preview.

PUT IT INTO PRACTICE

A real-world example

Ask support users how helpful the reply was, while customers who answered No skip that follow-up. This avoids forcing non-users to invent an answer.

Good to know

  • Keep branching simple enough for a colleague to explain. Complex branching needs a deliberate test checklist.
  • Do not use a name-piping example in an anonymous survey.
Build & logic / 07

Sections, pages and a comfortable flow

Sections group related questions. Pages break the respondent experience into steps. Separators create a visual pause without asking for an answer.

Step by step

  1. Add a Section before its related questions. Give it a useful heading and, if needed, a short explanation.

  2. Place questions inside the intended section using the builder controls. Questions in a section use the section’s page.

  3. Set page positions in the applicable field settings and keep page order consistent when rearranging the survey.

  4. Use Line separator sparingly to divide related blocks. Do not add a new section for every short question.

  5. Preview the full flow on Desktop and Phone. Check that each page has a clear purpose and that required fields are easy to find.

PUT IT INTO PRACTICE

A real-world example

A staff pulse survey might have “Working together”, “Tools and support” and “Your ideas” sections. A longer onboarding survey can put each topic on a separate page.

Good to know

  • Section colours are edited in Build. The survey’s main accent colour is controlled in Design & Branding.
Build & logic / 08

Choose the right privacy and collection mode

Arynox distinguishes identified, anonymous and controlled-anonymous collection. Choose the mode for your purpose before publishing and explain it honestly to respondents.

Step by step

  1. Open Build → Survey settings and review the available privacy modes. Identified collection is suitable when responses need to relate to known participants.

  2. Use anonymous collection when your questions should not identify the respondent. Avoid names, email addresses, identifying links and identifying free-text prompts.

  3. Controlled-anonymous collection uses controlled participation while protecting the response identity in the designed workflow. Review the privacy explanation and invitation behaviour before rollout.

  4. If privacy changes are restricted after publication or collection, use the available copy workflow instead of trying to reinterpret existing responses.

  5. Test the correct public or invitation link and confirm the introductory privacy message matches how you actually collect and use the data.

PUT IT INTO PRACTICE

A real-world example

An anonymous employee pulse should ask about team experience rather than require an email address. A service follow-up that needs a personal reply is better designed as identified feedback.

Good to know

  • Anonymous surveys restrict email and file questions. Free text can still contain personal information, so phrase instructions carefully.
  • Anonymous collection does not justify promising that voluntary comments can never identify someone.
Build & logic / 09

Submission limits and answer-based quotas

An overall submission limit controls the survey total. An answer quota controls the number accepted for a particular answer. They solve different sampling needs.

Step by step

  1. In Survey settings, set Maximum submissions. A value of 0 means unlimited within the applicable platform and plan allowances.

  2. Use answer-based quotas where a specific group needs a cap. Choose the question, matching value and limit; keep a distinct quota key.

  3. Save and publish the draft to apply quota changes. Review the displayed usage when updating an existing quota.

  4. Counts start when a quota is first published and persist across versions. Changing its matching question or answer starts a new count; removing the quota removes that limit after publishing.

  5. Test boundary behaviour before promoting the survey. A submission cap is not the same as a promise of one response per person.

PUT IT INTO PRACTICE

A real-world example

Recruit up to 50 responses from Vienna and 50 from Berlin while keeping an overall cap of 100. Set explicit city options so the matching answers are consistent.

Good to know

  • Anonymous surveys use a completion cookie to discourage repeats, but a browser cookie is not a verified identity.
Publishing / 10

Preview, save draft and publish with confidence

The shared toolbar stays available across the survey workspace. Preview, Save draft and Save & publish have different jobs; viewing a preview does not make changes public.

Demonstration screenshot · sample survey, no customer data. Select to enlarge. Controls can vary with plan, role and screen size.

Step by step

  1. Use Preview to review the current editing state, including unsaved changes supported by the active editor. Check text, layout, rules and language selection.

  2. Choose Save draft to keep your edits privately. The saved-status message tells you whether draft changes still need publishing.

  3. Choose Save & publish only when the draft is ready for respondents. Resolve any publish-readiness checks first.

  4. Use Open survey to view the respondent-facing published survey. It is separate from an editing preview and may behave according to the current collection mode.

  5. After publishing, verify the live link and selected language. Existing responses remain attached to the version originally answered.

PUT IT INTO PRACTICE

A real-world example

You adjust a theme, inspect it in Preview, then save it as a draft for review. Customers continue seeing the published version until you publish the revision.

Good to know

  • A theme selection is only a preview until Apply theme; applying it updates the editor and is still separate from saving and publishing.
Publishing / 11

Reset a draft, restore versions and manage a survey

Manage brings survey actions and published versions together. Resetting a draft and restoring an older version both affect the editing copy; they do not silently replace the current live version.

Step by step

  1. Open Manage and use Reset draft to published when you want the draft to match the current published version again. Review the confirmation because draft edits will be discarded.

  2. Open Published versions to inspect available versions. Restore a selected version to draft if you want to work from an earlier definition.

  3. Preview the restored draft, edit if needed and publish when ready. A survey without a published version has no live definition to reset to.

  4. Use Duplicate survey to create a separate starting point, or Save as template when a reusable structure belongs in your organisation’s library.

  5. Use collection and archive actions deliberately. Closing collection stops new participation; archiving is an organisational lifecycle action. Existing results are not a substitute for a backup.

PUT IT INTO PRACTICE

A real-world example

A seasonal feedback survey can be duplicated and updated for the new event. An accidental design experiment can be discarded by resetting the draft to the published version.

Good to know

  • Read the confirmation before any destructive action. Deleting a survey can remove its responses and files.
Design & branding / 12

Choose a theme, then make it your own

Themes give you a coordinated starting palette. Appearance controls let you refine that palette, so you do not need to choose every colour from scratch.

Demonstration screenshot · sample survey, no customer data. Select to enlarge. Controls can vary with plan, role and screen size.

Step by step

  1. Open Design & Branding → Appearance. Filter the theme gallery by category, including gradients, solid colours, education, children and science.

  2. Select a theme to preview it. Review the saved-theme label and the selected preview before applying anything.

  3. Choose Keep my current page background if you only want the new palette. Apply theme updates the editing controls; Undo theme lets you reverse that theme application.

  4. Refine Text colour, Survey panel and Accent colour. Accent colours style buttons, selections and the survey’s top border.

  5. Check the preview on Desktop and Phone, then save the draft or publish when ready. Keep text readable against both the panel and surrounding page.

PUT IT INTO PRACTICE

A real-world example

A science outreach survey can start with a research-inspired theme. A professional feedback form can use a quiet lavender-to-blue gradient with a white survey panel.

Good to know

  • Choosing a theme does not replace your logo, font or layout. Section colours are controlled separately in Build.
Design & branding / 13

Gradients, patterns and your own page image

Page background means the full HTML page surrounding the survey panel. Survey panel colour controls the surface containing the questions. Treat those as two distinct layers.

Step by step

  1. Choose a background type: a solid colour, gradient, pattern or your image. Use the gallery category filter to narrow the available styles.

  2. For a custom gradient, choose the available colour stops and adjust its angle. Preview the balance around the survey panel.

  3. For patterns, adjust the pattern colour and intensity. Use the size slider from 25% to 1000% and rotation from 0° to 360°.

  4. For your own image, use an appropriate uploaded asset where your plan supports it. Avoid an image that becomes distracting or unreadable when cropped on a phone.

  5. Keep the question panel distinct. Test both light and dark areas of the page and use subtle intensity for busy patterns.

PUT IT INTO PRACTICE

A real-world example

A children’s activity survey can use larger stars at low intensity. A research questionnaire can use a fine grid. A hotel can use a restrained brand photograph behind a plain panel.

Good to know

  • Scaling to 1000% makes pattern elements much larger, not more detailed. The same pattern controls apply after choosing a patterned theme.
Design & branding / 14

Logos, typography and your asset library

A consistent identity helps respondents recognise your survey. Logo & identity and Files & logos keep brand assets close to the design controls.

Step by step

  1. Open Design & Branding and choose the logo or identity section. Select or upload the asset supported by your current plan.

  2. Review the logo placement, size and layout controls. Use a clean image with enough surrounding space so it remains legible on mobile.

  3. Choose a font, button style, width and corner treatment that support your brand. Avoid making the survey unusually narrow or visually crowded.

  4. Use Files & logos to find the assets already associated with the survey. Use the organisation branding tools for shared identity settings where available.

  5. Preview image and PDF content before publishing. Keep the file name and description meaningful to the person who will view it.

PUT IT INTO PRACTICE

A real-world example

An organisation uses its logo on every customer survey, a consistent blue accent and a simple sans-serif typeface, while choosing different page backgrounds for different campaigns.

Good to know

  • Available assets, branding options and upload limits depend on plan and installation settings.
Languages / 15

Create, edit, enable and delete translations

Languages lets one survey contain several translations. The original language remains the source, while each added language has its own translated text and enabled state.

Step by step

  1. Open Languages and confirm the original survey language. Add the target language you want to support.

  2. Translate the title, introduction, question labels, help text, choices, rows and other text presented by the editor. Include the completion heading and thank-you message.

  3. Enable a language when it is ready. Disable it to keep the translation in the draft without offering it as an active respondent language.

  4. Use the edit controls to maintain an existing language. Delete a translation only when you no longer need that language’s text.

  5. Preview and publish the full language update using the shared toolbar. After editing the original questions, review each translation again for changed meaning or missing text.

PUT IT INTO PRACTICE

A real-world example

A customer survey starts in English and offers German and French. Each translation uses the same underlying questions so the survey structure remains consistent.

Good to know

  • Deleting or disabling a draft translation does not change the current published survey until you publish.
  • Use a fluent reviewer for important customer-facing wording.
Languages / 16

Browser-language selection and the Google Translate helper

Arynox can select an existing enabled translation using the visitor’s browser language preferences. Detection chooses text you have provided; it does not generate a translation.

Step by step

  1. Add and publish the languages your audience needs. A browser language can only match a translation that is available in that published survey.

  2. Test a matching language, a regional variant and an unsupported language. The original language is the fallback when no suitable translation is available.

  3. A respondent’s explicit language choice takes priority over automatic preference matching. Remembered choices can also affect later visits.

  4. In the translation editor, use Open in Google Translate for a source field. It opens the external translation page with the source and target languages.

  5. Review the suggested translation and copy it back into the matching field. For long text, use Copy original and paste it on the translation page. Then save and publish through Arynox.

PUT IT INTO PRACTICE

A real-world example

A German-preference browser can open the published German translation of an English survey. A Spanish-preference browser falls back to the original if no Spanish translation is enabled.

Good to know

  • The helper needs no translation API key, but it does not automatically import results. Text opened in Google Translate is sent to that external service.
  • Browser settings often follow system preferences, but Arynox does not directly inspect a visitor’s operating-system settings.
Collect & outreach / 17

Share a link or download a QR code

Collect connects your published survey to its audience. Choose the right sharing method for the place where people will encounter it.

Step by step

  1. Publish the survey and open Collect. Check the collection state, privacy mode and test/live setting before sharing.

  2. Copy the appropriate public link for an open survey. If your plan supports a custom short code, choose one that is memorable and review the final link.

  3. Generate or download the QR code where available. Scan it on a real phone before printing or distributing it.

  4. Put a short explanation next to the code: what the survey is for, how long it takes and who should answer. Include a readable link as an alternative.

  5. For controlled or personal invitations, use the invitation workflow instead of replacing personal links with a public link.

PUT IT INTO PRACTICE

A real-world example

Place a QR code on a café receipt or an event poster. A short “Tell us about your visit” caption gives people a reason to scan.

Good to know

  • Leave clear space around printed QR codes, avoid distortion and test the actual printed size.
  • Opening a link is not the same as submitting a response.
Collect & outreach / 18

Test mode, live collection and closing responses

Publication and collection are separate decisions. A survey can have a published version while still being in test mode or closed to new responses.

Step by step

  1. Review the Test or Live indicator in the survey workspace. Use test collection while checking layout, rules and end-to-end behaviour.

  2. Submit example responses through the appropriate test link and inspect what appears in Results. Keep track of test submissions before launch.

  3. When ready, change the supported collection setting to live and verify the respondent link again.

  4. Use Close collection when you want to stop accepting new responses. Reopen it through the available controls when appropriate.

  5. If someone cannot submit, check closure, response limits, quotas, invitation validity and plan access before changing the questionnaire.

PUT IT INTO PRACTICE

A real-world example

An event organiser tests the survey with colleagues on Thursday, switches to live for Friday’s event and closes collection after the feedback deadline.

Good to know

  • Retained test submissions can appear in counts. Do not interpret a dashboard total as a guaranteed count of live respondents.
Collect & outreach / 19

Manage contacts responsibly

Contacts are your invitation audience, not the same as survey responses. Consent and suppression controls help determine who should receive outreach.

Step by step

  1. Open Contacts to add or edit individual records. Use clear names and valid email addresses.

  2. For CSV imports, follow the columns shown by the import screen, including email, name and consent where requested. Inspect a small sample before importing a larger list.

  3. Review existing records and duplicate handling. Do not assume importing a file grants permission to send invitations.

  4. Use suppression controls when a contact should not receive campaign mail. Keep the invitation purpose aligned with what recipients expect.

  5. Choose the intended recipients when building a campaign, then review the send list before starting it.

PUT IT INTO PRACTICE

A real-world example

A training provider imports the participants who agreed to receive session feedback requests, then suppresses anyone who should no longer receive those emails.

Good to know

  • A contact’s email address should not be copied into anonymous survey questions.
Collect & outreach / 20

Invitations, campaigns and reminders

Campaigns help send survey invitations to a chosen audience. Review both the message and the eligible-recipient list before initiating a send.

Step by step

  1. Open Campaigns and create or edit a campaign for the intended survey. Select the appropriate contacts and invitation settings.

  2. Write a clear subject and message. Explain why the recipient is receiving the invitation and use the survey link provided by the campaign workflow.

  3. Review the campaign, schedule or start it through the available controls, and check the confirmation.

  4. Use reminders for eligible recipients where supported. Review who will receive them rather than repeatedly sending the original campaign to everyone.

  5. Check Email delivery for queued, accepted, failed or suppressed messages. Resolve the underlying reason before retrying failures.

PUT IT INTO PRACTICE

A real-world example

After a conference, invite attendees to give feedback and send a carefully timed reminder to the recipients still eligible for one.

Good to know

  • Personal, single-use links belong to the intended invitation flow. Do not publish them on a public poster.
  • A queued or accepted message is not proof of inbox delivery or a completed response.
Results & reporting / 21

Read responses and turn them into action

Results combines question summaries with individual response inspection. Start with the decision the survey was designed to support and keep the context of each result in view.

Step by step

  1. Open the survey’s Results tab. Review the relevant version and available filters before comparing numbers.

  2. Look at distributions, not just a single average. A mixed set of very high and very low ratings can hide behind a moderate average.

  3. Read comments alongside structured answers. Avoid treating a memorable comment as representative of everyone.

  4. Inspect individual responses where your role permits it. Use internal notes for your team’s follow-up rather than rewriting the respondent’s answer.

  5. Agree on an action, owner and review date. Consider a follow-up survey using comparable questions to see whether the change helped.

PUT IT INTO PRACTICE

A real-world example

A service team sees good friendliness ratings but weak waiting-time scores. Comments mention the lunchtime queue, so the team trials a staffing change rather than redesigning the whole service.

Good to know

  • Existing responses belong to the version answered. A renamed question does not retroactively change the experience that produced an older answer.
Results & reporting / 22

Filters, exports and shared reports

Reporting tools help you share a focused view of results. Export scope and shared-link scope should match what you intend the recipient to see.

Step by step

  1. Apply the relevant survey, version and answer filters before reviewing or exporting. Confirm the visible scope in the results tools.

  2. Use CSV for a portable tabular export. XLSX availability depends on the installation. Check column labels and date handling in your spreadsheet tool.

  3. Save a useful report view where supported so your team can return to a consistent selection.

  4. Use aggregate report sharing when a recipient needs summaries rather than access to your whole customer portal. Set an expiry where the sharing controls provide one.

  5. Open a shared report as the recipient would and verify its scope before forwarding the link. Revoke or replace links when access should end.

PUT IT INTO PRACTICE

A real-world example

A school shares aggregate workshop feedback with facilitators while keeping individual comments restricted to the organising team.

Good to know

  • Exported files leave the platform’s access controls. Store and share them according to your organisation’s own practices.
Results & reporting / 23

Understand NPS and rating results

NPS asks how likely someone is to recommend something on a 0–10 scale. A rating question can use a different scale and should not automatically be interpreted as NPS.

Step by step

  1. Use the dedicated Net Promoter Score field for a recommendation question. Keep its standard 0–10 answer range.

  2. For NPS interpretation, 9–10 are promoters, 7–8 are passives and 0–6 are detractors. NPS is the percentage of promoters minus the percentage of detractors.

  3. Read the score with the number of responses and the audience in mind. Small or changing samples can move the result substantially.

  4. Use an optional comment or a targeted follow-up to understand the reasons behind the number.

  5. Compare like with like: question wording, audience, timing and collection method should remain consistent if you are tracking a trend.

PUT IT INTO PRACTICE

A real-world example

With 60 promoters, 25 passives and 15 detractors out of 100 responses, NPS is 60 − 15 = 45. This is a score, not a 45% satisfaction rating.

Good to know

  • Do not turn a 1–5 satisfaction scale into NPS by simply relabelling the result.
Account & support / 24

Workspaces, users and permissions

Your organisation’s roles determine which controls and data a person can access. Shared working should use appropriate accounts and invitations, rather than sharing passwords.

Step by step

  1. Use the account selector to confirm you are working in the intended organisation. Survey and dashboard data follow that active context.

  2. If your role permits it, open Users & roles to invite colleagues and choose the appropriate role.

  3. Give creators editing access and analysts the reporting access they need. Review custom role permissions where available.

  4. Use workspaces to organise surveys by team or purpose. Keep names clear so people choose the right destination when creating a survey.

  5. Review access when someone changes role or leaves. Use My Account for your own profile, password and sign-in security.

PUT IT INTO PRACTICE

A real-world example

A customer-experience lead builds surveys, a colleague analyses results and an organisation owner manages subscription and team access.

Good to know

  • Missing navigation items can reflect your role; they do not necessarily mean the feature is broken.
  • Workspace organisation is not a promise of a separate security boundary beyond the permissions your organisation actually configures.
Account & support / 25

Plans, allowances and limited-duration access

Plans define the features and usage available to your account. Some offers have a limited duration; do not assume a plan’s name tells you whether it expires.

Step by step

  1. Open Subscription to inspect the active plan and available changes. Review the stated allowances and any limited-access duration.

  2. Use Billing & invoices for billing details and available payment or invoice actions, according to your role.

  3. If a feature is unavailable, check both your role and your plan. Upload, branding, QR and other capabilities may have separate allowances.

  4. When access expires, follow the offered upgrade or plan-change path. Review the notice describing how your current plan behaves.

  5. Contact support if a purchase or entitlement appears inconsistent. Include the relevant account and a clear description, without sending payment secrets.

PUT IT INTO PRACTICE

A real-world example

A team uses a time-limited introductory offer, reviews its expiry date and chooses a suitable plan before launching a longer campaign.

Good to know

  • Existing data is retained when limited access ends, but editing or collection behaviour depends on the plan and platform rules shown for the account.
Account & support / 26

Support conversations and notifications

Support keeps your questions and replies together. The top-of-page notification helps you notice updates without scrolling down to the support menu.

Step by step

  1. Open Support to review current and older tickets in their sections. Open the relevant ticket before starting a duplicate conversation.

  2. Read the newest answer at the top, then reply in the same ticket with the requested details.

  3. Opening a ticket marks the displayed updates as viewed. Mark it unread manually if you want a reminder to return.

  4. When updates are viewed or no qualifying updates remain, the unread notice should disappear. Completed and archived states follow the configured notification behaviour.

  5. Open My Account → Support settings to choose sound preferences. Your browser may need an initial interaction before it can play a soft notification sound.

PUT IT INTO PRACTICE

A real-world example

A customer reports a missing translation, receives a top-of-page support notice, opens the answer and replies with the survey title and the language affected.

Good to know

  • Include what you expected, what happened and which page or survey is involved. Use screenshots with sensitive details removed.
Account & support / 27

API keys, webhooks and connected workflows

Connect Arynox to your own tools through scoped API keys, signed response webhooks and verified custom survey domains. Availability follows your plan and any customer-specific agreement.

Step by step

  1. Open Integrations in the customer portal. Choose API keys, Webhooks or Custom domains.

  2. Read your effective allowances in the Developer Centre. API permissions require both the key and the current customer agreement.

  3. Create a separate expiring key for each server-side integration. Keep it out of browser code, public repositories and screenshots.

  4. Use the API v1 guide for read and write examples. Saving through the API creates or edits a draft; publishing is a separate operation.

  5. Set up response webhooks if you need your system to learn when a response arrives. Keep the private worker running and validate signatures.

PUT IT INTO PRACTICE

A real-world example

A team uses a supported response event to trigger a follow-up process in its own system, while keeping the receiving workflow responsible for its own validation and access controls.

Good to know

  • Ask your administrator for the exact API and webhook contract for your installation.
Troubleshooting / 28

When something does not look right

Work from the visible state and a reproducible example. A draft, a preview and the published survey can legitimately show different versions.

Step by step

  1. Changes missing from the live survey: check the saved-status message, publish the intended draft and reopen the published link.

  2. Wrong language: confirm that the translation is enabled and published. Check explicit or remembered language choices before testing browser preference detection.

  3. Cannot submit: review required fields, validation, collection closure, invitation validity, quotas, submission limits and plan access.

  4. Missing email: inspect the delivery state and recipient eligibility. Check suppression and spam folders; accepted by a mail server does not guarantee inbox placement.

  5. Layout problem: compare the same published version and language on the affected screen size. Capture a clean screenshot and note browser, page and steps.

  6. Unexpected unread notice: open the relevant ticket and read the latest reply. Check whether it was manually marked unread and whether another ticket still has updates.

PUT IT INTO PRACTICE

A real-world example

“German completion message is still English” is easier to diagnose with the survey title, selected language and confirmation that the translated completion text was published.

Good to know

  • Do not repeatedly resubmit a real survey just to diagnose a display problem. Use Preview or a deliberate test workflow.
Publishing / 29

Your launch checklist

A polished survey should feel easy, coherent and trustworthy. Take one final pass through content, design and collection before inviting your audience.

Step by step

  1. Purpose: the introduction explains why you are asking, who should answer and how feedback will be used.

  2. Questions: labels are neutral, options are complete and every required field is necessary. Test each conditional route.

  3. Design: text is readable, images are appropriate and the page works on Desktop and Phone.

  4. Languages: review every enabled translation, including answer choices and the completion message.

  5. Collection: confirm the published version, privacy mode, test/live state, link or invitation, quotas and submission limit.

  6. Follow-through: check that results appear as expected and decide who will review and act on them.

PUT IT INTO PRACTICE

A real-world example

Before putting a QR code on 500 printed cards, scan one proof, complete the intended survey path and verify the final thank-you message.

Good to know

  • Use a colleague as a fresh pair of eyes. People familiar with a survey often overlook ambiguous wording.
Field types / 30

Single choice

Choose exactly one answer from visible options.

Step by step

  1. Open Build → Add fields and select Single choice.

  2. Use for one main reason, one preference or a yes/no decision. Add the field, enter at least two unique options and decide whether an answer is required.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

Which part of your visit mattered most?
PUT IT INTO PRACTICE

Example question

Which part of your visit mattered most?

Good to know

  • Do not use it when several answers can honestly apply.
Field types / 31

Multiple choice

Choose several answers from visible options.

Step by step

  1. Open Build → Add fields and select Multiple choice.

  2. Use for interests, feature requests or all applicable reasons. Set minimum and maximum selections when a deliberate limit is useful.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

Which improvements would you value?
PUT IT INTO PRACTICE

Example question

Which improvements would you value?

Good to know

  • Explain a maximum in the question: “Choose up to three”.
Field types / 32

Dropdown

Choose one answer from a compact list.

Step by step

  1. Open Build → Add fields and select Dropdown.

  2. Use for a longer list of mutually exclusive choices. Add clear options and keep the initial prompt distinct from a real answer.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

Which workshop did you attend?
PUT IT INTO PRACTICE

Example question

Which workshop did you attend?

Good to know

  • For two or three short choices, Single choice is often easier to scan.
Field types / 33

Short text

Collect a concise written answer.

Step by step

  1. Open Build → Add fields and select Short text.

  2. Use for a brief label, a short suggestion or an identified reference where appropriate. Set a sensible character limit and add help text if a format is expected.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

What one thing would you improve?
PUT IT INTO PRACTICE

Example question

What one thing would you improve?

Good to know

  • For detailed explanations, use Long text. Avoid identifying prompts in anonymous surveys.
Field types / 34

Long text

Give respondents room to explain their experience.

Step by step

  1. Open Build → Add fields and select Long text.

  2. Use for comments, stories and qualitative feedback. Keep the prompt focused and usually optional; review themes across comments rather than selecting only memorable examples.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

What would make your next visit better?
PUT IT INTO PRACTICE

Example question

What would make your next visit better?

Good to know

  • Ask one clear question. A large text box is not a reason to demand a long answer.
Field types / 35

Email or URL

Collect a validated email address or an HTTP/HTTPS web link.

Step by step

  1. Open Build → Add fields and select Email or URL.

  2. Choose Email or URL in the field settings. Use email for an identified follow-up and URL for a relevant website. The two formats validate differently.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

Where can we contact you?
PUT IT INTO PRACTICE

Example question

Where can we contact you?

Good to know

  • These fields are restricted by anonymous-survey rules. Do not add them merely to make an anonymous response identifiable.
Field types / 36

Number

Collect a numeric quantity with meaningful bounds.

Step by step

  1. Open Build → Add fields and select Number.

  2. Use for counts or measurements. Explain the unit and choose an appropriate minimum and maximum. Numeric input supports decimal values where applicable.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

How many sessions did you attend?
PUT IT INTO PRACTICE

Example question

How many sessions did you attend?

Good to know

  • A phone number, postcode or identifier is usually not a quantity and may lose leading zeros when treated as a number.
Field types / 37

Date and time

Collect a local date and time.

Step by step

  1. Open Build → Add fields and select Date and time.

  2. Use when a time as well as a date matters. Explain the expected local context, because the field is not itself an appointment-booking system.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

When did your visit take place?
PUT IT INTO PRACTICE

Example question

When did your visit take place?

Good to know

  • Do not promise that a selected time reserves a slot or automatically communicates a timezone.
Field types / 38

Rating

Collect a whole-number rating on a scale starting at 1.

Step by step

  1. Open Build → Add fields and select Rating.

  2. Choose the scale maximum, from 2 through 10, and explain what the endpoints mean. Use the same wording and range when tracking results over time.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

How useful was the session?
PUT IT INTO PRACTICE

Example question

How useful was the session?

Good to know

  • A 1–5 satisfaction rating is different from a 0–10 NPS recommendation question.
Field types / 39

Net Promoter Score

Ask a recommendation question on the standard 0–10 scale.

Step by step

  1. Open Build → Add fields and select Net Promoter Score.

  2. Use for likelihood to recommend, with 0 meaning not at all likely and 10 extremely likely. Follow up with an optional reason to make the number more useful.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

How likely are you to recommend us?
PUT IT INTO PRACTICE

Example question

How likely are you to recommend us?

Good to know

  • The dedicated scale runs from 0 to 10. See the NPS interpretation guide before reporting the score.
Field types / 40

Slider

Choose a numeric position between minimum and maximum values.

Step by step

  1. Open Build → Add fields and select Slider.

  2. Use for a bounded perception or approximate amount. Set meaningful limits and explain the endpoints so people know what they are moving toward.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

How confident do you feel, from 0 to 100?50
PUT IT INTO PRACTICE

Example question

How confident do you feel, from 0 to 100?

Good to know

  • For a small discrete rating scale, Rating can be clearer than a slider. Test touch and keyboard use.
Field types / 41

Matrix

Ask the same set of choices for several row topics.

Step by step

  1. Open Build → Add fields and select Matrix.

  2. Add row labels and shared answer options. Use it when topics genuinely share the same scale, such as clarity, pace and usefulness. Review the phone layout.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

How was each part of the experience?
PUT IT INTO PRACTICE

Example question

How was each part of the experience?

Good to know

  • Keep matrices short; repeated rows can cause people to answer without reading.
Field types / 42

Ranking

Put all listed options into a preference order.

Step by step

  1. Open Build → Add fields and select Ranking.

  2. Enter the items to rank. Respondents assign each option once across the rank positions. Use a short list when relative priority matters more than a separate score.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

Which priorities matter most?
PUT IT INTO PRACTICE

Example question

Which priorities matter most?

Good to know

  • Ranking requires a trade-off. For independent ratings, use Rating or Matrix instead.
Field types / 43

File upload

Request a supporting document or image.

Step by step

  1. Open Build → Add fields and select File upload.

  2. Use only when a file is necessary and the survey mode permits it. The respondent control supports PDF, PNG, JPEG and plain text; the installation controls the size limit.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

Attach a relevant example if helpful.PDF, PNG, JPEG or plain text. Maximum 5 MB. Avoid personal identifiers in anonymous surveys.
PUT IT INTO PRACTICE

Example question

Attach a relevant example if helpful.

Good to know

  • File questions are restricted in anonymous surveys. Tell people not to upload unrelated personal or confidential information.
Field types / 44

Consent

Collect an explicit agreement using a checkbox.

Step by step

  1. Open Build → Add fields and select Consent.

  2. Write the statement clearly and provide the relevant information before asking for agreement. Decide deliberately whether agreement must be required.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

I have read the participation information.
PUT IT INTO PRACTICE

Example question

I have read the participation information.

Good to know

  • A checkbox alone does not decide whether your wording or process meets your organisation’s obligations.
Field types / 45

Display content

Add explanatory text without collecting an answer.

Step by step

  1. Open Build → Add fields and select Display content.

  2. Use for instructions, a short privacy explanation or a transition between topics. Put the main information in the content text and keep it easy to skim.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

A little context before we begin

Your feedback helps us plan the next session. Please answer about your own experience.

PUT IT INTO PRACTICE

Example question

A little context before we begin

Good to know

  • It is not a question and does not contribute an answer to your results.
Field types / 46

Image or PDF content

Show supporting media as part of your survey.

Step by step

  1. Open Build → Add fields and select Image or PDF content.

  2. Choose an uploaded image or PDF from the supported content controls. Give it a useful title and place the related questions directly after it.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

Example concept image showing three stages: ask, listen and improve
Example image content. A PDF asset would be presented as a file link.
PUT IT INTO PRACTICE

Example question

Review the concept before answering.

Good to know

  • This displays your content; File upload asks the respondent to supply a file.
Field types / 47

Section

Group related questions under a heading.

Step by step

  1. Open Build → Add fields and select Section.

  2. Insert a section before its questions, name the topic and add a short explanation if needed. Assign related fields to it and keep their page consistent.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.

Your experience

A short introduction to a group of related questions.

PUT IT INTO PRACTICE

Example question

Your experience

Good to know

  • Use sections for meaningful topics, not just to add decoration between every question.
Field types / 48

Line separator

Add a visual break without adding an answer field.

Step by step

  1. Open Build → Add fields and select Line separator.

  2. Use between short groups where a full section heading is unnecessary. Preview the spacing so the page remains cohesive.

  3. Add any applicable help text, required-answer rule and validation. Preview the field in context, then save your draft.

TRY THE FIELD · EXAMPLE ONLY

Explore the control below. Nothing is submitted or saved.


PUT IT INTO PRACTICE

Example question

A new topic

Good to know

  • A divider does not create a new page or collect a response.
Use cases / 49

Recipe: customer experience feedback

Learn what is working and what one change would help most. Keep this close to the experience you want people to remember.

Step by step

  1. Start with a Display content introduction explaining that the survey is about the recent visit or purchase.

  2. Add Single choice for the relevant service or product, Rating for the experience and Long text for an optional improvement.

  3. If using NPS, ask a recommendation question rather than reusing the satisfaction wording. Add a reason only if you plan to read it.

  4. Use your brand palette, preview on a phone and share the published link or a tested QR code at the point of experience.

  5. Review distributions and comments together. Pick one action to trial and repeat the same core questions after the change.

PUT IT INTO PRACTICE

A real-world example

A hotel asks about check-in, room comfort and one improvement. If the goal is service follow-up, use an appropriate identified process rather than promising anonymity.

Good to know

  • Avoid a long catalogue of every touchpoint if you only need to improve one decision.
Use cases / 50

Recipe: a thoughtful employee pulse

A team pulse should invite useful feedback without creating confusion about privacy. Short, repeated questions can help track a specific change.

Step by step

  1. Explain who will review results and how they will be used. Choose the correct privacy mode before adding fields.

  2. Use a short Matrix or several Ratings for topics such as clarity, workload and support. Keep the same scale throughout.

  3. Add one optional Long text question about what would help. Do not require names or identifying details in an anonymous questionnaire.

  4. Offer the languages your team needs and review the translated wording with fluent colleagues.

  5. Report findings in a way that respects your stated privacy approach and tell the team what action will follow.

PUT IT INTO PRACTICE

A real-world example

After introducing a new working process, ask about clarity and available support, then compare a later pulse using the same wording.

Good to know

  • Be cautious when reporting small groups or unusually identifying comments.
Use cases / 51

Recipe: learning and workshop feedback

Match the survey to the learners’ reading level and the decision the educator needs to make. A friendly design should support understanding rather than distract from it.

Step by step

  1. Use a clear introductory statement and simple labels. Choose an education theme or a subtle pattern with high-contrast text.

  2. Ask a Rating about confidence or usefulness, Single choice about the most helpful activity and optional Long text for a suggestion.

  3. Use Display content or an Image field to provide context when needed; keep the number of questions modest.

  4. Check the actual phone layout and any shared-device workflow before distributing a link or QR code.

  5. Use the feedback to change the next session and explain the improvement to participants.

PUT IT INTO PRACTICE

A real-world example

After a science workshop, students rate their confidence, choose the activity they learned most from and suggest one thing to explain differently.

Good to know

  • Follow your organisation’s requirements for surveys involving children and avoid unnecessary personal information.
Use cases / 52

Recipe: structured research and concept testing

A research questionnaire benefits from consistent wording, explicit eligibility and a clear plan for analysing responses.

Step by step

  1. Use Display content for the study explanation and Consent where appropriate to your process.

  2. Add eligibility questions before relevant conditional follow-ups. Test both eligible and ineligible paths.

  3. Use Media to show a concept, Rating or Matrix for comparable judgments and Ranking for a short set of priorities.

  4. If using quotas, define the answer groups and limits before launch. Review translations for meaning, not just literal wording.

  5. Keep a record of the published version and export the appropriate scope for analysis.

PUT IT INTO PRACTICE

A real-world example

A design team shows a concept image, asks about clarity and usefulness, and ranks three proposed improvements. It keeps the concept explanation consistent across languages.

Good to know

  • The platform supplies collection tools; it does not by itself establish sampling quality or scientific validity.
Use cases / 53

Recipe: event feedback that leads somewhere

Event feedback works best when the attendee can answer while the experience is fresh and the organiser knows what decision will follow.

Step by step

  1. Ask which session the person attended using Dropdown or Single choice.

  2. Use a consistent Rating for usefulness and a brief optional comment for the next event.

  3. Show follow-ups only for relevant sessions where conditional logic makes the survey shorter.

  4. Print a tested QR code or send a campaign to the appropriate consenting recipients. Set a clear collection window.

  5. Review the results by the relevant session and share actionable feedback with the organisers.

PUT IT INTO PRACTICE

A real-world example

A conference asks for session selection, usefulness and a topic request for next year, rather than asking every attendee to rate sessions they did not attend.

Good to know

  • Do not equate the number of survey responses with total attendance.
Troubleshooting / 54

A–Z: the words you will see

Use this quick reference when a label in the platform is unfamiliar.

Step by step

  1. Accent: the colour used for key survey controls. Asset: an uploaded image, PDF or brand file. Branching: showing or ending questions based on an earlier answer.

  2. Campaign: an invitation or reminder workflow for a chosen audience. Collection: the process of accepting survey responses. Draft: your editable, unpublished working copy.

  3. Enabled language: a translation offered when it is part of the published survey. Field: a question, content item or layout element. Filter: a way to narrow the records or guide topics you see.

  4. NPS: recommendation score based on a 0–10 question. Panel: the surface containing the survey questions. Preview: a way to inspect current work before publication.

  5. Published version: the definition respondents answer. QR code: a scannable representation of a link. Quota: an accepted-response limit for a matching answer.

  6. Required: an answer needed to proceed when the question applies. Section: a group of related fields. Suppression: preventing a contact from receiving outreach.

  7. Theme: a coordinated appearance preset. Translation: language-specific text for the same survey. Workspace: an organisational grouping for your surveys.

PUT IT INTO PRACTICE

A real-world example

If you want to change the colours outside the question area, look for Page background. If you want the questions’ white surface to change, look for Survey panel.

Integrations / 55

Connect a custom survey domain

Connect a survey address such as feedback.yourcompany.com in four stages: choose your address, add two DNS records, wait for secure activation, and make it your default. Your normal portal sign-in stays the same.

Step by step

  1. Before you begin: you need a domain your organisation owns, access to its DNS settings, and a plan that includes custom domains. If someone else manages DNS, send them the exact records shown in your portal. You do not need to move your company website or email.

  2. Open Integrations → Custom domains. Choose a dedicated address such as feedback.yourcompany.com. Enter it without https://, a slash, a port or a survey path. Click Add domain to generate your unique DNS instructions.

  3. Sign in to the provider that manages your domain DNS. This may be your registrar, hosting company or another DNS provider. Open DNS settings, DNS records or Zone Editor. Select the zone for your company domain.

  4. Add a TXT record. Copy the TXT record name and the entire TXT record value displayed by Arynox, including arynox-verification=. Do not use a token from an example or another customer. Leave TTL at its default and save.

  5. Add a CNAME record. Copy the displayed CNAME record name and CNAME target. Enter the target as a hostname, without https://. If a proxy switch is offered, choose DNS only. Leave TTL at its default and save.

  6. Check how your DNS provider handles names. For feedback.example.com in the example.com zone, some providers want feedback for the CNAME name and _arynox.feedback for the TXT name; others want the complete names. Check the saved names so example.com is not appended twice.

  7. Return to Custom domains. Background checks detect the DNS records. When hosting automation is enabled, Arynox also configures hosting and requests HTTPS. Otherwise, contact support to complete hosting. You can click Verify DNS & HTTPS to check readiness and refresh the page to see progress.

  8. Wait for Active. Waiting for DNS means ownership or CNAME routing has not passed. Waiting for secure connection means hosting or the HTTPS certificate is still being prepared. Setup needs attention means read the displayed message and contact support if it describes a hosting issue. Certificate issuance can take several checks; repeated clicks do not make it faster.

  9. Click Use as default after activation. Open your survey → Collect, copy a new sharing link or download a new QR code, and test it before sending it to respondents. Previously distributed Arynox links still work; existing printed QR codes are not rewritten.

  10. Keep both DNS records in place. Set the Active/Disabled switch to Disabled to block the custom address immediately. New links use the platform address. Enable it again, verify, and select Use as default. Delete disables the address immediately and queues hosting cleanup; existing links and QR codes stop working. Your surveys and responses are retained, and you can share the original Arynox address.

PUT IT INTO PRACTICE

A real-world example

A hotel uses feedback.hotel.example for guest feedback. Its guests see the hotel’s survey design, and the hotel team manages results in its normal Arynox portal.

Good to know

  • Only respondent pages use the custom domain. Customer and administrator sign-in remain on the main Arynox address.
  • Use a dedicated subdomain. Wildcard and apex-domain routing are not supported. cPanel automation is optional and depends on hosting permissions.
  • Removing or disabling a domain breaks links and printed QR codes that use that domain; distribute the original Arynox link when needed.
  • If a record already exists for your chosen survey subdomain, ask your DNS administrator before replacing it. A CNAME cannot share its exact name with an A or AAAA record. Do not delete unrelated company website or email records.
  • If stuck, send support your survey hostname and the status message shown in Arynox. Never send DNS account passwords or hosting API tokens.
  • If your DNS is hosted in the platform’s connected cPanel account, automatic setup may briefly prepare and restore the verified CNAME. Leave both records and the domain entry in place; several background checks may be needed. Support handles any hosting conflict.
  • Deleting a domain removes its survey hosting entry in the background. Your DNS records are retained, including local customer records restored if cPanel removes them during hosting cleanup. The shared application folder is never deleted. Cleanup can take several scheduled checks.
Integrations / 56

Start with the API and Developer Centre

API v1 provides 19 operations for survey drafts, publishing, translations, sharing links, collection channels, responses, summaries, contacts, workspaces, domain states and webhook delivery states.

Step by step

  1. Open Integrations → API keys to see your current access, monthly usage, requests per minute and available permissions. Limits are shared across all workspace keys.

  2. Create a named key with only the permissions your integration needs and an expiry of 1–365 days. Copy it immediately. A key cannot grant permissions its creator does not have; later role or plan restrictions also apply.

  3. Send GET to https://YOUR-ARYNOX-HOST/api.php?v=1&path=workspaces with Authorization: Bearer YOUR_KEY. This requires workspace.read. Then GET path=surveys with surveys.read.

  4. Use limit (1–100) and offset for lists. Follow pagination.next_offset until it is null. Use a separate key for each integration so it can be revoked independently.

  5. Download the OpenAPI specification from the Developer Centre. Review recent API outcomes there when troubleshooting; request logs omit keys and response bodies.

  6. Revoke an unused key immediately. An invalid or expired key returns 401; a disabled feature or missing permission returns 403; exhausted quotas return 429.

PUT IT INTO PRACTICE

A real-world example

A reporting service uses a key with responses.read and reports.read. It pulls only the response data it needs and never receives permission to edit or publish surveys.

Good to know

  • This release does not send invitations or submit survey answers through the API. Use the existing campaign and respondent workflows.
  • Legacy resource=surveys and resource=responses reads still work, but now enforce plan access and quotas. Legacy keys without an issuer remain limited to the original read permissions.
Integrations / 57

Create, translate and publish safely through the API

Write operations use JSON, revision checks and retry protection. Draft edits never silently update the published survey.

Step by step

  1. POST path=surveys with title and workspace_id. Optional mode selects anonymous, identified or controlled_anonymous at creation. An optional definition uses the same structure as the builder.

  2. For every POST or PATCH, send Content-Type: application/json and a unique Idempotency-Key of 8–100 letters, numbers, dots, underscores, colons or hyphens. Retry an uncertain request with the same key and identical body.

  3. GET path=surveys/ID to read the current revision and draft. PATCH the same path with revision and a full definition or a new title. A complete definition replaces the draft, so retain fields and translations you want to keep.

  4. Translations, appearance and completion messages live inside the definition. Use a builder-created draft as your reference and preserve its structure; the API applies the application’s validators.

  5. POST path=surveys/ID/publish with the latest revision and surveys.publish permission. This runs publishing checks and live-survey limits and creates a new immutable version.

  6. POST path=surveys/ID/close with revision to stop collection. Publishing does not change the separate Test/Live collection setting; check it in Collect before sending a link to real respondents.

  7. On 409 revision_conflict, reread the survey and reconcile changes. On 409 idempotency_conflict, do not reuse that key for a different operation.

PUT IT INTO PRACTICE

A real-world example

Create a draft with {"title":"Workshop feedback","workspace_id":1}. Read the returned id and revision, update the questions, then publish in a separate explicitly authorised operation.

Good to know

  • Privacy-mode changes are deliberately handled through the portal’s privacy-copy workflow to preserve existing promises.
  • Idempotency results are retained for 30 days. After that, a reused key may be treated as a new operation. Use a fresh key for each new operation.
Integrations / 58

Read feedback and keep contacts in sync

Use filtered responses, daily totals and contact records without granting unrestricted platform access.

Step by step

  1. GET path=surveys/ID/responses with responses.read. Optional from and to values are YYYY-MM-DD; version_id restricts a published version. Follow pagination.

  2. GET path=surveys/ID/summary with reports.read for the filtered total and up to 366 most recent daily buckets. Retained test responses are included; these counts are not the billing allowance.

  3. GET path=surveys/ID/links for the preferred branded URL and the original Arynox URL. Controlled-anonymous surveys still require individual invitations.

  4. GET path=contacts to read contacts. POST path=contacts with email, optional name, and boolean consent/suppressed fields to create one. Consent defaults to false.

  5. When first granting consent, supply consent_note explaining the permission. PATCH path=contacts/ID to change details. The API cannot re-enable an already suppressed contact.

  6. GET path=usage to see effective API access and monthly consumption, or path=webhooks to inspect response-event delivery states. The latter also requires webhook access.

PUT IT INTO PRACTICE

A real-world example

A workshop system creates a contact only after permission has been recorded, then uses reporting endpoints to compare daily feedback totals. An unsubscribed contact stays suppressed.

Good to know

  • Anonymous response results omit the identity_email field. Free-text answers can still contain identifying information provided by a respondent; handle exports appropriately.
  • An API key belongs to one organisation. IDs from another organisation return not found rather than exposing its data.
Administration / 59

Configure domains, API access and customer agreements

Manage standard packages at plan level and individual Enterprise agreements at customer level. Platform-wide switches always take priority.

Step by step

  1. Apply the database upgrade through the administrator portal. Existing plans keep their original read-only API and response-webhook access. New plans default to integrations disabled until you choose otherwise.

  2. Open Settings → Domains & integrations. Set the domain CNAME target and domain/webhook switches. The existing API platform switch remains under Portal settings.

  3. Edit a plan and open its Features section. Configure API, custom domains, webhooks, domain allowance, per-minute/monthly API limits and permitted API operations. A domain or monthly limit of 0 means unlimited; requests per minute must be at least 1.

  4. Open a customer organisation and find Customer integration agreement. Every feature, limit and API permission group offers Use plan setting, showing the inherited value. Choose Custom limit to enter an individual allowance, or Custom permissions to choose operations.

  5. Review Effective access after saving. Disabling API access blocks existing keys; disabling domains prevents their respondent routing. Configurations remain stored. Lower domain limits retain access only for the earliest registered domains within the new limit.

  6. For automatic hosting, save the cPanel API server hostname, account username, relative survey public folder and API token in Settings → Domains & integrations. Test the saved connection, then enable automation. Your existing worker handles pending connections; enabling automation sets the built-in domain job to every five minutes. Manual hosting remains available.

  7. Check the Developer Centre’s recent requests and the scheduled job history. Enterprise is a commercial agreement, not a bypass of platform switches or tenant isolation.

  8. For a hosting move, finish pending DNS recovery first. Back up the database, files, storage and application key. Prepare the new platform DNS and HTTPS, then set Platform public URL in Domains & integrations. Blank uses the installation configuration. Update the worker path on the destination.

  9. Save the new cPanel connection with automation off. Account home folder is optional and defaults to /home/username; Public folder is relative to that home. Test, then enable. Keep the connection-target hostname where possible and point its DNS to the new host; changing its name requires customers to update their CNAME.

  10. Open Custom domains in the main admin menu to see all customer domains. Each row provides Active/Disabled, Verify and Delete with hostname confirmation. Platform connection configuration stays under Settings → Domains & integrations.

  11. Both dashboards show verified, disabled, pending, attention and cleanup counts. Customer dashboards show only their own domains. Deleting a customer organisation queues its domain cleanup even after its access is suspended. Deleting an individual team member does not remove domains belonging to a still-owned organisation.

PUT IT INTO PRACTICE

A real-world example

Business includes one domain and read-only reporting. A particular Enterprise customer gets three domains and survey-writing permissions through customer overrides, while other Business customers retain their standard limits.

Good to know

  • The Plans page displays the saved plan allowances. Customer-specific overrides are shown inside that customer’s portal, not advertised as benefits for everyone.
  • Changing a plan or customer setting does not modify Stripe prices or charge a customer. The worker can create hosting entries and request HTTPS through cPanel; cPanel AutoSSL manages renewals.
  • Restore all plan settings removes every integration override for this customer. A domain count is an allowance: Custom domains must also be enabled. The agreement shows any plan, customer or platform blocker and missing connection setup.
  • The connection test verifies account access, the exact survey folder and readable AutoSSL status. Only a real customer setup proves domain-creation and certificate-issuance permissions. Tokens are encrypted; blank retains the saved token. Removing a domain disables routing immediately and queues hosting removal. Shared certificate files and application files are not deleted.
  • The automatic DNS-conflict path handles the connected cPanel account. Domains in another cPanel account on the same server may need provider-level coordination. External DNS customers keep managing their own TXT and CNAME. The platform never moves other accounts’ domains.
  • Open Customer domain connections to view DNS recovery progress and cPanel diagnostics. Keep the hosting connection available until restoration or cleanup finishes. Other control panels need a provider adapter or manual hosting.
YOU DO NOT HAVE TO FIGURE IT OUT ALONE

A little help goes a long way.

Tell us what you are trying to do. We’ll help you find the next step.

Get in touch ↗