# Troubleshooting Github and Bitbucket integration issues

**URL:** <https://community.transifex.com/t/troubleshooting-github-and-bitbucket-integration-issues/1551>\
**Category:** Tips and Tricks\
**Created:** [December 5, 2019, 11:18am UTC](https://community.transifex.com/t/troubleshooting-github-and-bitbucket-integration-issues/1551 "2019-12-05T11:18:43Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![anthonydim](https://avatars.discourse-cdn.com/v4/letter/a/3e96dc/32.png) [@anthonydim](https://community.transifex.com/u/anthonydim)\
**Post date:** [December 5, 2019, 11:18am UTC](https://community.transifex.com/t/troubleshooting-github-and-bitbucket-integration-issues/1551/1 "2019-12-05T11:18:43Z")

</div>

`A. Scenario: Check for the following if you don't have existing resources in Transifex and you can't push files from Github/Bitbucket into Transifex?`

1. file\_format:

- Needs to be in all caps and must match the i18N file type designation for your file format as indicated in our documentation: [https://docs.transifex.com/formats/introduction](https://docs.transifex.com/formats/introduction). Example: Enter PO and not po for this type of file.

1. source\_file\_dir (filter\_type: dir)

- This is the directory in Github/Bitbucket where you store source files.

- The directory can’t start with a forward slash. I.e ‘/’. Example: `/directoryname` is invalid. Entry should be `directoryname`.

- The directory must exist in Github/Bitbucket.

1. source\_file: (filter\_type: file)

- The source file location can’t start with a forward slash, i.e ‘/’. Example: `/locale/fileTest/example.po` is invalid. Entry should be `locale/fileTest/example.po`.

`B. Scenario: Check for the following if you don't have existing resources in Transifex and you can't pull translations from Transifex into Github/Bitbucket?`

1. Check for open PR’s (All filter types, option selected to create PR)

- The integration will create one PR for each resource-language pair. For example if you have a resource called android.xml which you want translated into French, Greek and Spanish a separate PR will be created when French is completely translated/reviewed, a separate one for Greek when it is completely translated/reviewed and so on.

- If an existing PR remains open in your repository then Transifex will append to the existing PR and it will not create a new one.

1. Place single quotes around your translation\_files\_expression  
**E.g: `translation_files_expression: 'Translations/<lang>'`**

2. Use the keyword in the directory name only. (only for filter\_type: dir)

· Valid syntax: `'Translations/<lang>/'`.  
· Invalid syntax: `'Translations/<lang>.strings'`

1. Translation file name must equal source file name

This is applied to filter\_type:dir. This does not apply to a filter\_type: file.

1. If you are committing translations directly to a Branch then you can’t use protected branches for this integration.

2. The user that installed the integration at the organization level (organization settings) needs to be the same user that configures the integration at the project level.

C. Scenario

1. You are configuring the integration for the first time and you have existing TX resources you want to sync to your repository. If the integration creates a new resource in Transifex instead of using the existing one, then:

- Make sure that your resource in Transifex has the same name as the resource in Github.
- Note: The integration does not remove the reviewed state of existing resources during the syncing process.

---

<div class="post-metadata">

**Author:** ![daghb](https://yyz2.discourse-cdn.com/flex030/user_avatar/community.transifex.com/daghb/32/831_2.png) [@daghb](https://community.transifex.com/u/daghb)\
**Post date:** [December 9, 2019, 2:07pm UTC](https://community.transifex.com/t/troubleshooting-github-and-bitbucket-integration-issues/1551/2 "2019-12-09T14:07:32Z")

</div>

> [@anthonydim](#):
>
> - Make sure that your resource in Transifex has the same name as the resource in Github.

What exactly does this mean?

---

<div class="post-metadata">

**Author:** ![anthonydim](https://avatars.discourse-cdn.com/v4/letter/a/3e96dc/32.png) [@anthonydim](https://community.transifex.com/u/anthonydim)\
**Post date:** [December 9, 2019, 5:28pm UTC](https://community.transifex.com/t/troubleshooting-github-and-bitbucket-integration-issues/1551/3 "2019-12-09T17:28:41Z")

</div>

If you have an existing resource in Transifex that you are trying to sync with Github/bitbucket then the integration looks at the name of the file in Transifex (ex. Django.po) and tries to find a file with the equivalent name in your repository in order to perform the synchronization.

Please let me know if this answers your question.
