How To Use Twine, Level One

Each section of your Twine project is a box called a passage. To add a passage, you could click the green +Passage button in the bottom-right corner, but the easiest way is to simply create a link. Twine 2 will automatically create a New Passage for you every time you create a link. More about creating links in a moment.
To edit a passage, double-click it.


A passage has three main fields: the title of the passage, tags, and the body. You can name other passages anything you like, but do not use the same passage name twice. Tags are only used for special types of code, so you can ignore the tags section. Everything that you type in the body will be shown to the player.



linklinklinkLinks between passages are shown as arrows between passages. Links are like doors to other passages. They are the same as being told to turn to another page in a Choose Your Own Adventure book. Links are marked in the text of a passage by two square brackets:

[[This is a link]]

The text between the brackets must match the title of the passage that it links to. Passage titles are case-sensitive, which means that “Blue door” and “BLUE DOOR” are NOT the same.




It is possible to change what text is shown to the player for a link. This can come in handy if you want to hide the title of the passage from the player. You can do that with an arrow, like this:

[[The text you want to display->The REAL Passage Title]]

For example: You may want to send the player to a passage called “Wrong” without letting them know that the link they are clicking is wrong. You can do this:

[[New York City is the capital of New York->Wrong]]

If your project has a broken link in it, it is shown in red, and clicking it shows an error message:


Here is an example of a passage body with links:

You decide to go to the hotel dining room.
You [[read the newspaper]] and order a coffee.
You get the strange feeling that some is watching you.

[[Look behind you]]
[[Hide under the table]]
[[Go back to your room->You lose]]



Here is an example of a multiple choice question with links:

How many sides does an octagon have?

[[7->Wrong]] [[8->Question 2]] [[9->Wrong]]

The correct answer takes the player to a passage called “Question 2.” All of the incorrect answers take you to a passage called “Wrong” which could look like this:

I’m sorry. That is incorrect.
Click the back arrow and try again.


To view your project, click the Play button in the bottom-right. Twine will open your project in a new browser tab.

To save your finished project, click the menu in the bottom-left with the name of your project and then Publish to File. The project will save as an HTML file (a webpage).


CONTINUE TO THE NEXT POST: Twine Pictures, GIFs, and Background Images