How to Fill Out Your Form

Simple step-by-step instructions

🎨 Theme:

Quick Start Guide

Someone sent you a link to fill out a form. Here's how to do it:

Step 1: Fill in the Required Fields

When you open the link, you'll see colored blocks on the screen arranged in a puzzle. Each block can have smaller child blocks connected to it on the right - these child blocks are where you'll find the textboxes to type your information.

What to do:
  1. 1. Click on any textbox inside a text/numeric child block to get started (pressing Tab will move to the next textbox)
  2. 2. Type information - your name, a number, whatever it asks for
  3. 3. Click on the next textbox (or press Tab) and fill that in too
  4. 4. Keep going until all the textboxes shown are filled.
  5. 5. If you need to add more information, click the Dropdown Menu at the top of a parent block to add a child block.
💡 Remember: Textboxes are inside text/numeric child blocks (like text, number, or choice blocks). The parent blocks (like "Pet" or "Contact Info") contain these child blocks. For choice blocks, you'll see a dropdown instead of a textbox.
💡 Tip: Red bubbles at the bottom of the screen or in the API controls panel mean you have errors that need to be fixed. Click the bubble to see the error message and where to fix it.

Step 2: Add More Information (If Needed)

Some blocks have extra information you can add. This is optional - you don't have to do it.

Adding optional fields:
  1. 1. Look at the top of a block - you'll see a dropdown menu (a little arrow you can click)
  2. 2. Click the dropdown to see a list of extra things you can add
  3. 3. Click on one from the list
  4. 4. A new block will appear at the bottom right of the existing block - fill it in if you want
  5. 5. You can delete optional blocks by clicking the "–" button next to them on the parent block.
💡 Remember: These are optional. It's a good practice to at least look at the dropdown and see what's available. You can skip this step if you don't need to add anything extra.

Step 3: Add Items to Lists

If your form has a list of things (like multiple addresses, or a list of tags), you can add more items to it.

How to add to a list:
  1. 1. Find a block that says it's a list (it might say "tags" or "items" or something like that)
  2. 2. Look for a "+" button on that block and click it
  3. 3. A new block appears inside the list - type something in it
  4. 4. Click "+" again if you want to add more items or the "–" button to delete an item
💡 Tip: The form may enforce a limit on the number of items in a list, or even a minimum number of items. Be aware of any red errors that pop up when you add to a list.

Step 4: Check for Errors

Before you submit, make sure everything is filled in correctly.

How to check for errors:
  1. 1. Look at the bottom-right corner of the page
  2. 2. If you see a red circle with an X (❌), you have an error
  3. 3. Click the red circle to see what's wrong
  4. 4. Fix the problem it tells you about
  5. 5. The red circle will disappear when everything is fixed
Common problems:
  • Missing information: You forgot to fill in a required block - just fill it in
  • Wrong choice: You picked something that's not allowed - try a different option
  • Wrong type: You put text where a number should go (or vice versa) - fix it
  • Wrong format: You put the wrong format for a date, email, phone number, etc. - fix it
⚠️ Important: You shouldn't submit your form if there's a red circle showing. It will almost always fail! Knowing this in advance is one of the key advantages of Blockforger.

Step 5: Submit Your Form

Once everything is filled in and there are no errors, you're ready to submit!

How to submit:
  1. 1. Look at the right side of the screen - that's the control panel
  2. 2. If you don't see it, look for a button or arrow that says "API Controls" and click it
  3. 3. Find the button that says "CREATE" or has a similar name. This button should always be under "HTTP Methods" on the left side of the panel.
  4. 4. Click that button
  5. 5. Wait a moment - you'll see a message telling you if it worked and the area below will turn either red or green to indicate success or failure.
💡 Tip: The form creator might change the button to match the kind of data you're submitting like "Create record" or "Sign up" or "Send message" - just click the main button on the left side.

Step 6: See If It Worked

After you click submit, you'll see a message telling you what happened.

What the colors mean:
  • Green message:Success! Your form was submitted and everything worked. You're done!
  • Red message:Something went wrong. Read the message to see what the problem is, fix it, and try again.
Where to look:
  1. 1. After clicking submit, look in the right side panel
  2. 2. Scroll down to find a section that shows the result
  3. 3. Look for a green area (and numbers like 200 or 201) - that means success!
  4. 4. If you see a red area (and numbers like 400 or 500), something went wrong - read the message and fix it
💡 Remember: Green = good! Red = data was rejected. If it's green, you're all done!

Need More Help?

I Can't Find a Field

If you're looking for a field that's not showing:

  • It might be optional - use the dropdown at the top of a block to add it
  • It might exist in a different block. For example, a phone number might be in a "Contact Info" block instead of a "Personal Info" block. Look for a dropdown on the "Personal Info" block to add a "Contact Info" block.
  • If you still can't find it, the person who designed the form might not have included it: ask them!

The Form Won't Submit

If the submit button doesn't work:

  • Try waiting at least 10 seconds, the form may be processing. Some of our clients are too cheap to use a dedicated server if you can believe that! Yep, that's a cold joke about cold starts.
  • Check for the red circle X with "Validation Error" in the bottom-left corner - you probably have errors that need fixing
  • Try clicking the red circle to see what's wrong
  • Fix all the errors, then try submitting again
  • If you're getting red errors, check what the numbers say! 500-599 errors are usually server errors, 400-499 errors are more likely to be your fault.
  • 400 is the most likely error to be your fault. This code is specifically reserved for client errors. Check your input and try again.
  • 401 indicates that you're not logged in, or your login expired. Sign out, then sign in again.
  • 403 indicates that you're not allowed to submit the form. Ask the form creator for access, they are the ones who can grant you access.
  • 500 indicates that the server is having a problem. Wait a few minutes and try again.
  • If you're sure you've filled it in correctly, the form creator might have made a mistake. Ask them!

I Made a Mistake

No problem! You can fix mistakes:

  • Just click on the textbox in the block with the mistake and type the correct information
  • If you added something by mistake, look for a "–" button (minus sign) to remove it
  • You can change anything before you submit
  • If you want to reload the workspace, make sure anything you want to keep is attached to the root block. Then click the "Rebuild link+blocks" button.
  • If the form is having an issue, you can send the form creator a link to the form with the issue so they can take a look at it.
  • If bad data was successfully submitted, keep the API control panel open and save the id first. There is usually a separate Delete button to remove the bad data.
  • Typically, you put the id in the ID field, select the right DELETE endpoint from the endpoint dropdown, and click the Delete button.
  • If you're not sure what to do, ask the form creator for help. Procedures for deleting data usually exist and are documented, but may vary from client to client.